> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 광고 단위 조회

> ID로 광고 단위를 조회합니다.

**접근 제어:**
Admin과 Operator 계정은 광고 단위 리소스에 전체 접근 권한(생성/조회/수정/삭제)을 가집니다.
Advertiser 계정은 이 엔드포인트에 접근할 수 없습니다 — 배정 대상 선택용 경량 조회 뷰는 `GET /ad-units/targets`를 참고하세요.



## OpenAPI

````yaml /openapi/adm.openapi.ko-dev.json get /api/manager/ad-units/{ad_unit_id}
openapi: 3.1.0
info:
  description: >-
    ## 소개

    Data Management API는 광고 및 추천 시스템이 활용하는 **다양한 데이터를** 종합적으로 관리해, Decision API가
    정확하고 효율적으로 작동할 수 있도록 돕습니다.


    캠페인이나 지면을 신규 등록하고 수정·삭제하는 것은 물론, **로그 및 통계 분석을** 통해 시스템 운영에 필요한 인사이트를 확보합니다.
    이렇게 확보된 데이터와 통계는 Decision API에서 최적화된 광고·콘텐츠를 결정하는 데 활용되며, 전체 광고·추천 시스템의 성능
    향상에 이바지합니다.
  title: 데이터 관리 API
  version: dev
servers: []
security: []
tags:
  - description: 인증 엔드포인트. 모든 역할(admin/operator/advertiser)이 로그인·토큰 갱신·본인 자격 증명 관리에 사용합니다.
    name: 인증
  - description: >-
      광고주 계정 관리. 운영자·관리자가 광고주를 온보딩하고 예산을 관리하며 계정을 비활성화합니다. 광고주는 본인 프로필과 잔액만 조회할
      수 있습니다.
    name: 광고주
  - description: >-
      내부 사용자(운영자/관리자) 계정 관리. 관리자 전용. 운영자 계정 생성, 역할 변경, 활성화 상태 토글, 계정 영구 삭제를
      다룹니다.
    name: 사용자
  - description: >-
      광고 단위 관리. 광고 단위와 관련 리소스를 관리합니다. 광고 단위는 code와 상위 경로에서 파생된 계층 경로 구조로 구성됩니다.
      admin·operator만 접근 가능하며 광고주는 원천 인벤토리에 접근할 수 없습니다.
    name: 광고 단위
  - description: 광고 카탈로그 관리. 광고 카탈로그 CRUD와 공유 링크를 통한 공개 조회를 제공합니다.
    name: 광고 카탈로그
  - description: 수요 파트너(광고 소스) 관리. 광고 단위에 수요를 공급하는 외부 광고 소스를 CRUD합니다.
    name: 수요 파트너
  - description: 게재 할당 관리. 광고 항목을 광고 단위 등 게재 대상에 연결합니다. CRUD, 상태별 카운트, 단건 조회를 제공합니다.
    name: 게재 할당
  - description: 연관 상품 풀(관리자). 추천 파이프라인에서 사용하는 연관 상품 풀의 일괄 저장/삭제 및 조회.
    name: 연관 상품 풀
  - description: 커스텀 타게팅 세그먼트 관리. 커스텀 타게팅 세그먼트의 CRUD 및 일괄 작업.
    name: 커스텀 타게팅 세그먼트
  - description: 감사 로그 조회. 관리 작업에 대한 시스템 감사 로그를 조회합니다.
    name: 감사 로그
  - description: 소재 차단 목록. 소재를 차단/차단 해제해 게재에서 제외합니다.
    name: 차단 소재
  - description: 카탈로그 항목 관리. 상품/데이터 카탈로그 항목을 조회·수정합니다.
    name: 카탈로그
  - description: 광고 소재 관리. 운영자·관리자가 소재를 관리하며 광고주는 본인 소재만 조회합니다. 연결된 LICA가 있으면 삭제가 차단됩니다.
    name: 소재
  - description: 대시보드 집계. 콘솔 대시보드용 요약·인벤토리·광고 항목 지표 롤업.
    name: 대시보드
  - description: 실험 관리. A/B·최적화 실험의 CRUD.
    name: 실험
  - description: 외부 소재 조회. 외부 수요 소스에서 수집된 소재를 읽기 전용으로 조회합니다.
    name: 외부 소재
  - description: 외부 연동 관리. 연동 소스(외부 데이터/서빙 커넥터)를 관리하고 연결을 테스트하며, 민감 설정이 마스킹된 공개 설정을 조회합니다.
    name: 연동
  - description: >-
      소재-광고 항목 연결(LICA). 소재를 광고 항목에 연결하며, 일괄 생성/삭제(최대 100, 부분 실패 허용)와 대시보드 카운트를
      제공합니다.
    name: 소재-광고 항목 연결(LICA)
  - description: 라이선스 정보. 사용 가능한 라이선스 기능과 사용량 지표를 조회합니다.
    name: 라이선스
  - description: >-
      광고 항목 관리. 생성·수정·삭제, 일괄 작업(최대 100, 부분 실패 허용), 상태 전환을 다룹니다. 광고 항목은 상위 주문
      아래에서 예산·목표·일정·타게팅을 정의합니다.
    name: 광고 항목
  - description: 미디어 라이브러리. 소재에 쓰이는 미디어 파일을 조회·업로드·삭제합니다.
    name: 미디어 라이브러리
  - description: 지표 조회 엔드포인트. 광고 단위·소재·광고 항목 등 엔티티의 집계 지표를 조회합니다.
    name: 지표
  - description: >-
      주문 관리. 운영자·관리자가 예산 단위로 광고 항목을 묶는 주문을 생성·관리하며, 광고주는 본인 주문을 조회합니다. 일괄 작업(최대
      100)과 draft 상태 삭제 규칙을 포함합니다.
    name: 주문
  - description: 게재 위치 관리. 게재 위치는 광고 단위를 게재 표면에 매핑합니다. CRUD와 게재 위치에 연결된 광고 단위 교체를 제공합니다.
    name: 게재 위치
  - description: 시스템 설정. 사이트 로고·Public URL·TLS·액세스 토큰 재생성을 포함한 시스템 구성을 조회·수정합니다.
    name: 설정
  - description: 시스템 리소스. 사이트 로고 등 공개 정적 리소스.
    name: 시스템
  - description: 개발자/운영용 제어 엔드포인트. 저수준 ext 변경과 헬스 체크. 일반 API 소비자가 아닌 내부 운영용입니다.
    name: 개발자/운영
  - description: 운영용 게재 할당 제어. 게재 할당 ext/상태 강제 변경(관리자 전용).
    name: 개발자/게재 할당 제어
  - description: 광고 서빙 모니터링(운영). 광고 서빙 현황·광고 단위 모니터링 이력·알림을 조회합니다.
    name: 개발자/모니터링
  - description: 내부 헬스/프로브 엔드포인트.
    name: 내부
  - description: '특정 리소스에 속하지 않는 매니저 공통 유틸리티 엔드포인트(예: 서비스 헬스).'
    name: 매니저(공통)
  - description: 광고 단위, 네이티브 포맷 및 네이티브 스타일 간의 매핑을 관리합니다.
    name: Ad Unit Native Style
  - description: 커스텀 타게팅 키와 활성화 상태를 관리하고 일괄 작업을 수행합니다.
    name: Custom Targeting Key
  - description: 커스텀 타게팅 키에 속한 값과 활성화 상태를 관리하고 일괄 작업을 수행합니다.
    name: Custom Targeting Value
  - description: 네이티브 포맷과 각 포맷을 구성하는 필드를 관리합니다.
    name: Native Format
  - description: 네이티브 스타일에 사용할 수 있는 템플릿을 조회합니다.
    name: Native Style Template
  - description: 네이티브 렌더링 스타일을 관리합니다.
    name: Native Style
paths:
  /api/manager/ad-units/{ad_unit_id}:
    get:
      tags:
        - 광고 단위
      summary: 광고 단위 조회
      description: >-
        ID로 광고 단위를 조회합니다.


        **접근 제어:**

        Admin과 Operator 계정은 광고 단위 리소스에 전체 접근 권한(생성/조회/수정/삭제)을 가집니다.

        Advertiser 계정은 이 엔드포인트에 접근할 수 없습니다 — 배정 대상 선택용 경량 조회 뷰는 `GET
        /ad-units/targets`를 참고하세요.
      operationId: handle_get_ad_unit_api_manager_ad_units__ad_unit_id__get
      parameters:
        - in: path
          name: ad_unit_id
          required: true
          schema:
            format: uuid
            title: Ad Unit Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdUnitDetailResponse'
          description: 성공 응답
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: 권한 없음
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: 리소스를 찾을 수 없음
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: 유효성 검사 오류
      security:
        - HTTPBearer: []
components:
  schemas:
    AdUnitDetailResponse:
      description: 광고 단위 조회 응답 스키마 — 생성자 이름 포함.
      properties:
        ad_unit_sizes:
          anyOf:
            - items:
                $ref: '#/components/schemas/AdUnitSize'
              type: array
            - type: 'null'
          description: |-
            타게팅 메타데이터 크기.
            서빙·렌더링을 좌우하는 display/video.w/h와는 별개입니다.
          title: Ad Unit Sizes
        code:
          description: 광고 단위 코드 식별자.
          title: Code
          type: string
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Created At
        created_by:
          description: 광고 단위를 생성한 사용자 ID.
          format: uuid
          title: Created By
          type: string
        created_by_name:
          anyOf:
            - type: string
            - type: 'null'
          description: 광고 단위를 생성한 사용자 이름.
          title: Created By Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 광고 단위 설명.
          title: Description
        display:
          $ref: >-
            #/components/schemas/a2_adm__domains__inventory__schemas__DisplayPlacement
          description: 디스플레이 게재 위치 설정.
        ext:
          $ref: '#/components/schemas/AdUnitExt'
          description: 광고 단위 확장 필드.
        gpid:
          anyOf:
            - type: string
            - type: 'null'
          description: OpenRTB imp.ext.gpid에 사용되는 표준 지면 ID.
          title: Gpid
        id:
          description: 광고 단위 ID (uuid7)
          format: uuid
          title: Id
          type: string
        instl:
          $ref: '#/components/schemas/Instl'
          default: 0
          description: |-
            인터스티셜 지면 여부. 0 = 아니오, 1 = 예.
            디스플레이·동영상·네이티브 전체에 적용됩니다.
        is_active:
          anyOf:
            - type: boolean
            - type: 'null'
          description: 광고 단위 활성 여부.
          title: Is Active
        name:
          description: 광고 단위 이름.
          title: Name
          type: string
        native:
          $ref: '#/components/schemas/NativePlacement'
          default:
            assets: []
          description: >-
            네이티브 지면임을 나타내는 지면 서브타입 객체입니다. (AdCOM 표준이 아닌 OpenRTB Native Ads 1.2
            Native Markup Request Object 기반)
        'no':
          anyOf:
            - type: integer
            - type: 'null'
          title: 'No'
        path:
          description: '광고 단위의 계층 경로 (예: "parent_id/child_id").'
          title: Path
          type: string
        recommendation:
          $ref: '#/components/schemas/RecommendationPlacement-Output'
          default:
            ext: {}
            topn: 10
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Updated At
        video:
          $ref: '#/components/schemas/VideoPlacement'
          description: 비디오 게재 위치 설정.
      required:
        - id
        - code
        - created_by
        - name
        - path
      title: AdUnitDetailResponse
      type: object
    HTTPExceptionResponse:
      properties:
        detail:
          description: 오류에 대한 상세 설명
          title: Detail
          type: string
      required:
        - detail
      title: HTTPExceptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AdUnitSize:
      properties:
        h:
          description: 높이 (픽셀).
          minimum: 0
          title: H
          type: integer
        w:
          description: 너비 (픽셀).
          minimum: 0
          title: W
          type: integer
      required:
        - h
        - w
      title: AdUnitSize
      type: object
    a2_adm__domains__inventory__schemas__DisplayPlacement:
      properties:
        ampren:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Ampren
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        clktype:
          $ref: '#/components/schemas/Click'
          default: 1
          description: '클릭 유형. 0: 없음, 1: 알 수 없음, 2: 내장 브라우저, 3: 네이티브 브라우저.'
        context:
          anyOf:
            - $ref: '#/components/schemas/DisplayContext'
            - type: 'null'
        ctype:
          anyOf:
            - items:
                maximum: 255
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Ctype
        displayfmt:
          $ref: '#/components/schemas/DisplayFormat'
          description: 디스플레이 포맷 설정.
        event:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventSpec'
              type: array
            - type: 'null'
          title: Event
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - type: number
            - type: 'null'
          default: 250
          description: '`unit`으로 지정된 단위의 게재 높이.'
          title: H
        ifrbust:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Ifrbust
        mime:
          description: 지원 MIME 타입 목록.
          items:
            type: string
          title: Mime
          type: array
        pos:
          anyOf:
            - $ref: '#/components/schemas/PlacementPosition'
            - type: 'null'
        priv:
          default: 0
          description: 개인정보 링크 표시 여부.
          title: Priv
          type: integer
        ptype:
          anyOf:
            - $ref: '#/components/schemas/DisplayPlacementTypes'
            - type: 'null'
        topframe:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Topframe
        unit:
          $ref: '#/components/schemas/Size'
          default: 2
          description: '크기 단위. 1: DIPS, 2: 인치, 3: 센티미터.'
        w:
          anyOf:
            - type: number
            - type: 'null'
          default: 300
          description: '`unit`으로 지정된 단위의 게재 너비.'
          title: W
      title: DisplayPlacement
      type: object
    AdUnitExt:
      properties:
        algorithm:
          default: axa0
          description: 광고 단위에 사용되는 알고리즘.
          title: Algorithm
          type: string
        approval_method:
          $ref: '#/components/schemas/AdUnitApproval'
          default: admin
          description: 광고 단위 승인 방식.
        bcat:
          default: []
          description: IAB 분류 체계 기반 차단 광고주 카테고리. 추가 민감 카테고리로 확장됨.
          items:
            type: string
          title: Bcat
          type: array
        default_cpa:
          default: 0
          description: 특정 목표 CPA가 없는 CPA 광고 항목의 기본 CPA. 기본값 0.0.
          title: Default Cpa
          type: number
        default_cpc:
          default: 0
          description: 특정 목표 CPC가 없는 CPC 광고 항목의 기본 CPC. 기본값 0.0.
          title: Default Cpc
          type: number
        display:
          default:
            enabled: 0
          description: JSON 형식의 디스플레이 전용 확장 데이터.
          title: Display
        external_raw_data:
          anyOf:
            - {}
            - type: 'null'
          description: 광고 단위의 외부 원천 데이터 (맵 형식).
          title: External Raw Data
        implicit_app_inference:
          anyOf:
            - $ref: '#/components/schemas/ImplicitAppInference'
            - type: 'null'
          description: UA 키워드 매핑을 통한 폴백/암묵적 모바일 앱 추론 설정.
        metric_mode:
          $ref: '#/components/schemas/AdUnitMetricMode'
          default: all
          description: '지표 공개 범위. all: 전체, internal_only: 내부 전용, external_only: 외부 전용.'
        native:
          $ref: '#/components/schemas/AdUnitExtNative'
          default:
            enabled: 0
            render_mode: html
          description: 네이티브 전용 확장 데이터.
        passback:
          anyOf:
            - {}
            - type: 'null'
          description: 광고 단위의 패스백 광고 태그 (맵 형식).
          title: Passback
        payout:
          $ref: '#/components/schemas/AdUnitPayout'
          default: rates
          description: 광고 단위 정산 유형.
        public_url:
          anyOf:
            - type: string
            - type: 'null'
          description: |-
            이 광고 단위의 이벤트 트래커 URL용 Public URL 재정의.
            설정 시 이 광고 단위에 대해 EdgeConfig.public_url을 덮어씁니다.
          title: Public Url
        publisher:
          anyOf:
            - {}
            - type: 'null'
          description: 광고 단위의 퍼블리셔 정보.
          title: Publisher
        recommendation:
          default:
            enabled: 0
          description: JSON 형식의 추천 전용 확장 데이터
          title: Recommendation
        responsive:
          $ref: '#/components/schemas/AdUnitResponsiveness'
          default: fixed
          description: 광고 단위 반응형 여부.
        target_ecpm:
          default: 0
          description: 광고 단위의 목표 eCPM (유효 1000회 노출당 비용). 기본값 0.0.
          title: Target Ecpm
          type: number
        target_service:
          anyOf:
            - type: string
            - type: 'null'
          description: 광고 단위 대상 서비스.
          title: Target Service
        video:
          default:
            enabled: 0
          description: JSON 형식의 비디오 전용 확장 데이터.
          title: Video
      title: AdUnitExt
      type: object
    Instl:
      enum:
        - 0
        - 1
      title: Instl
      type: integer
    NativePlacement:
      properties:
        assets:
          default: []
          description: 이 지면에 대한 네이티브 에셋 요청 정의 목록입니다.
          items:
            $ref: '#/components/schemas/AssetRequest'
          title: Assets
          type: array
        context:
          anyOf:
            - maximum: 65535
              minimum: 0
              type: integer
            - type: 'null'
          description: OpenRTB 네이티브 컨텍스트 유형 (1=콘텐츠 중심, 2=소셜 중심, 3=상품 컨텍스트)
          title: Context
        contextsubtype:
          anyOf:
            - maximum: 65535
              minimum: 0
              type: integer
            - type: 'null'
          description: 'OpenRTB 네이티브 컨텍스트 서브타입 (예: 14=이미지 중심 콘텐츠)'
          title: Contextsubtype
        ext:
          anyOf:
            - {}
            - type: 'null'
          description: 벤더별 선택적 확장 필드입니다.
          title: Ext
        plcmtcnt:
          anyOf:
            - maximum: 255
              minimum: 1
              type: integer
            - type: 'null'
          description: OpenRTB 네이티브 지면 노출 수
          title: Plcmtcnt
        plcmttype:
          anyOf:
            - maximum: 65535
              minimum: 0
              type: integer
            - type: 'null'
          description: OpenRTB 네이티브 지면 유형 (1=피드, 2=독립 단위, 3=콘텐츠 외부, 4=추천 위젯)
          title: Plcmttype
      title: NativePlacement
      type: object
    RecommendationPlacement-Output:
      properties:
        candidate_filtering:
          anyOf:
            - $ref: '#/components/schemas/CandidateFiltering'
            - type: 'null'
          description: 후보 필터링.
        content_filter_rule:
          anyOf:
            - $ref: '#/components/schemas/Expr-Output'
            - type: 'null'
          description: 콘텐츠 필터 규칙.
        ext:
          default: {}
          description: 광고 단위 전용 추가 확장.
          title: Ext
        topn:
          default: 10
          description: 추천할 항목 수.
          maximum: 99
          minimum: 0
          title: Topn
          type: integer
      title: RecommendationPlacement
      type: object
    VideoPlacement:
      properties:
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        boxing:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          default: 1
          title: Boxing
        clktype:
          $ref: '#/components/schemas/Click'
          default: 1
          description: '클릭 유형. 0: 없음, 1: 알 수 없음, 2: 내장 브라우저, 3: 네이티브 브라우저.'
        comp:
          anyOf:
            - items:
                $ref: '#/components/schemas/Companion'
              type: array
            - type: 'null'
          title: Comp
        comptype:
          anyOf:
            - items:
                $ref: '#/components/schemas/CompanionType'
              type: array
            - type: 'null'
          title: Comptype
        ctype:
          description: 소재 유형 목록.
          items:
            type: integer
          title: Ctype
          type: array
        delay:
          default: 0
          description: 광고 시작 지연 (초).
          title: Delay
          type: integer
        delivery:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeliveryMethod'
              type: array
            - type: 'null'
          title: Delivery
        expdir:
          anyOf:
            - items:
                $ref: '#/components/schemas/ExpandableDirection'
              type: array
            - type: 'null'
          title: Expdir
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          default: 300
          description: 비디오 높이 (px).
          title: H
          type: integer
        linear:
          default: 0
          description: '선형성. 0: 알 수 없음, 1: 선형, 2: 비선형.'
          title: Linear
          type: integer
        maxbitr:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Maxbitr
        maxdur:
          default: 0
          description: 최대 허용 길이 (초).
          title: Maxdur
          type: integer
        maxext:
          anyOf:
            - type: integer
            - type: 'null'
          default: 0
          title: Maxext
        maxseq:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Maxseq
        mime:
          description: 지원 MIME 타입 목록.
          items:
            type: string
          title: Mime
          type: array
        minbitr:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Minbitr
        mincpmpersec:
          anyOf:
            - type: number
            - type: 'null'
          title: Mincpmpersec
        mindur:
          default: 0
          description: 최소 허용 길이 (초).
          title: Mindur
          type: integer
        overlayexpdir:
          anyOf:
            - items:
                $ref: '#/components/schemas/ExpandableDirection'
              type: array
            - type: 'null'
          title: Overlayexpdir
        playend:
          anyOf:
            - $ref: '#/components/schemas/PlaybackCessationMode'
            - type: 'null'
        playmethod:
          description: 재생 방식 목록.
          items:
            $ref: '#/components/schemas/PlaybackMethod'
          title: Playmethod
          type: array
        poddur:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Poddur
        podid:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Podid
        podseq:
          anyOf:
            - $ref: '#/components/schemas/PodSequence'
            - type: 'null'
          default: 0
          description: '팟 순서. -1: 마지막, 0: 무관, 1: 처음.'
        pos:
          anyOf:
            - $ref: '#/components/schemas/PlacementPosition'
            - type: 'null'
        ptype:
          $ref: '#/components/schemas/PlacementSubtypeVideo'
          default: 1
          description: '비디오 게재 유형. 1: 인스트림, 2: 인배너, 3: 인아티클, 4: 인피드, 5: 전면.'
        rqddurs:
          anyOf:
            - items:
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Rqddurs
        skip:
          default: 0
          description: '건너뛰기 가능 플래그. 0: 불가, 1: 가능.'
          title: Skip
          type: integer
        skipafter:
          default: 0
          description: 건너뛰기 버튼이 나타나는 재생 위치 (초).
          title: Skipafter
          type: integer
        skipmin:
          default: 0
          description: 건너뛰기 버튼 표시 전 최소 광고 길이 (초).
          title: Skipmin
          type: integer
        slotinpod:
          anyOf:
            - $ref: '#/components/schemas/SlotPositionInPod'
            - type: 'null'
          default: 0
          description: '팟 내 슬롯 위치. -1: 마지막, 0: 무관, 1: 처음, 2: 처음 또는 마지막.'
        unit:
          anyOf:
            - $ref: '#/components/schemas/Size'
            - type: 'null'
          default: 2
          description: '크기 단위. 1: DIPS, 2: 인치, 3: 센티미터.'
        w:
          default: 480
          description: 비디오 너비 (px).
          title: W
          type: integer
      title: VideoPlacement
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    Click:
      enum:
        - 0
        - 1
        - 2
        - 3
      title: Click
      type: integer
    DisplayContext:
      enum:
        - ContentCentric
        - ArticleContent
        - VideoContent
        - AudioContent
        - ImageContent
        - UserGeneratedContent
        - SocialCentric
        - EmailContent
        - ChatContent
        - ProductContext
        - AppStore
        - ProductReviews
      title: DisplayContext
      type: string
    DisplayFormat:
      properties:
        expdir:
          anyOf:
            - $ref: '#/components/schemas/ExpandableDirection'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: H
        hratio:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Hratio
        w:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: W
        wratio:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Wratio
      title: DisplayFormat
      type: object
    EventSpec:
      properties:
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        jstrk:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Jstrk
        method:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventTrackingMethod'
              type: array
            - type: 'null'
          title: Method
        pxtrk:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Pxtrk
        type:
          $ref: '#/components/schemas/EventType'
        wjs:
          default: 1
          title: Wjs
          type: integer
        wpx:
          default: 1
          title: Wpx
          type: integer
      required:
        - type
      title: EventSpec
      type: object
    PlacementPosition:
      enum:
        - Unknown
        - AboveTheFold
        - Locked
        - BelowTheFold
        - Header
        - Footer
        - Sidebar
        - FullScreen
      title: PlacementPosition
      type: string
    DisplayPlacementTypes:
      enum:
        - Feed
        - AtomicUnit
        - OutsideCore
        - RecommendationWidget
      title: DisplayPlacementTypes
      type: string
    Size:
      enum:
        - 1
        - 2
        - 3
      title: Size
      type: integer
    AdUnitApproval:
      enum:
        - admin
        - delegate
      title: AdUnitApproval
      type: string
    ImplicitAppInference:
      properties:
        android_bundle:
          anyOf:
            - type: string
            - type: 'null'
          title: Android Bundle
        app_name:
          anyOf:
            - type: string
            - type: 'null'
          title: App Name
        cat:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Cat
        ios_bundle:
          anyOf:
            - type: string
            - type: 'null'
          title: Ios Bundle
        ua_keywords:
          default: []
          items:
            type: string
          title: Ua Keywords
          type: array
      title: ImplicitAppInference
      type: object
    AdUnitMetricMode:
      enum:
        - all
        - internal_only
        - external_only
      title: AdUnitMetricMode
      type: string
    AdUnitExtNative:
      properties:
        enabled:
          default: 0
          description: 네이티브 광고 단위 사용 여부 (0 또는 1).
          title: Enabled
          type: integer
        render_mode:
          $ref: '#/components/schemas/NativeRenderMode'
          default: html
          description: 이 광고 단위의 네이티브 렌더링 방식.
      title: AdUnitExtNative
      type: object
    AdUnitPayout:
      enum:
        - rates
        - revenue_share
        - none
      title: AdUnitPayout
      type: string
    AdUnitResponsiveness:
      enum:
        - fixed
        - resized
      title: AdUnitResponsiveness
      type: string
    AssetRequest:
      anyOf:
        - $ref: '#/components/schemas/AssetRequest1'
        - $ref: '#/components/schemas/AssetRequest2'
        - $ref: '#/components/schemas/AssetRequest3'
        - $ref: '#/components/schemas/AssetRequest4'
      title: AssetRequest
    CandidateFiltering:
      properties:
        method:
          $ref: '#/components/schemas/CandidateFilteringMethod'
          default: NoFilter
          description: 필터링 방식.
      title: CandidateFiltering
      type: object
    Expr-Output:
      anyOf:
        - $ref: '#/components/schemas/Expr1'
        - $ref: '#/components/schemas/Expr2-Output'
        - $ref: '#/components/schemas/Expr3-Output'
        - $ref: '#/components/schemas/Expr4-Output'
      title: Expr
    Companion:
      properties:
        display:
          anyOf:
            - $ref: >-
                #/components/schemas/a2_adm__generated__ad_unit__DisplayPlacement
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        vcm:
          anyOf:
            - type: integer
            - type: 'null'
          title: Vcm
      title: Companion
      type: object
    CompanionType:
      enum:
        - Static
        - HTML
        - IFrame
      title: CompanionType
      type: string
    DeliveryMethod:
      enum:
        - Streaming
        - Progressive
        - Download
      title: DeliveryMethod
      type: string
    ExpandableDirection:
      enum:
        - Left
        - Right
        - Up
        - Down
        - FullScreen
        - ResizeMinimize
      title: ExpandableDirection
      type: string
    PlaybackCessationMode:
      enum:
        - OnVideoCompletion
        - OnLeavingViewport
        - OnLeavingViewportContinuesAsAUnit
      title: PlaybackCessationMode
      type: string
    PlaybackMethod:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
      title: PlaybackMethod
      type: integer
    PodSequence:
      enum:
        - -1
        - 0
        - 1
      title: PodSequence
      type: integer
    PlacementSubtypeVideo:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      title: PlacementSubtypeVideo
      type: integer
    SlotPositionInPod:
      enum:
        - -1
        - 0
        - 1
        - 2
      title: SlotPositionInPod
      type: integer
    EventTrackingMethod:
      enum:
        - 1
        - 2
      title: EventTrackingMethod
      type: integer
    EventType:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      title: EventType
      type: integer
    NativeRenderMode:
      enum:
        - html
        - asset
      title: NativeRenderMode
      type: string
    AssetRequest1:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/DataAssetRequest'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          title: Id
          type: integer
        img:
          anyOf:
            - $ref: '#/components/schemas/ImageAssetRequest'
            - type: 'null'
        required:
          anyOf:
            - $ref: '#/components/schemas/IsRequired'
            - type: 'null'
        title:
          anyOf:
            - $ref: '#/components/schemas/TitleAssetRequest'
            - type: 'null'
        video:
          anyOf:
            - $ref: '#/components/schemas/VideoAssetRequest'
            - type: 'null'
      required:
        - id
        - title
      title: AssetRequest1
      type: object
    AssetRequest2:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/DataAssetRequest'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          title: Id
          type: integer
        img:
          anyOf:
            - $ref: '#/components/schemas/ImageAssetRequest'
            - type: 'null'
        required:
          anyOf:
            - $ref: '#/components/schemas/IsRequired'
            - type: 'null'
        title:
          anyOf:
            - $ref: '#/components/schemas/TitleAssetRequest'
            - type: 'null'
        video:
          anyOf:
            - $ref: '#/components/schemas/VideoAssetRequest'
            - type: 'null'
      required:
        - id
        - img
      title: AssetRequest2
      type: object
    AssetRequest3:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/DataAssetRequest'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          title: Id
          type: integer
        img:
          anyOf:
            - $ref: '#/components/schemas/ImageAssetRequest'
            - type: 'null'
        required:
          anyOf:
            - $ref: '#/components/schemas/IsRequired'
            - type: 'null'
        title:
          anyOf:
            - $ref: '#/components/schemas/TitleAssetRequest'
            - type: 'null'
        video:
          anyOf:
            - $ref: '#/components/schemas/VideoAssetRequest'
            - type: 'null'
      required:
        - id
        - video
      title: AssetRequest3
      type: object
    AssetRequest4:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/DataAssetRequest'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          title: Id
          type: integer
        img:
          anyOf:
            - $ref: '#/components/schemas/ImageAssetRequest'
            - type: 'null'
        required:
          anyOf:
            - $ref: '#/components/schemas/IsRequired'
            - type: 'null'
        title:
          anyOf:
            - $ref: '#/components/schemas/TitleAssetRequest'
            - type: 'null'
        video:
          anyOf:
            - $ref: '#/components/schemas/VideoAssetRequest'
            - type: 'null'
      required:
        - data
        - id
      title: AssetRequest4
      type: object
    CandidateFilteringMethod:
      enum:
        - NoFilter
        - ViewPenalty
        - ViewOut
      title: CandidateFilteringMethod
      type: string
    Expr1:
      properties:
        data:
          $ref: '#/components/schemas/Compare'
        type:
          const: cmp
          title: Type
          type: string
      required:
        - data
        - type
      title: Expr1
      type: object
    Expr2-Output:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Expr-Output'
          title: Data
          type: array
        type:
          const: and
          title: Type
          type: string
      required:
        - data
        - type
      title: Expr2
      type: object
    Expr3-Output:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Expr-Output'
          title: Data
          type: array
        type:
          const: or
          title: Type
          type: string
      required:
        - data
        - type
      title: Expr3
      type: object
    Expr4-Output:
      properties:
        data:
          $ref: '#/components/schemas/Expr-Output'
        type:
          const: not
          title: Type
          type: string
      required:
        - data
        - type
      title: Expr4
      type: object
    a2_adm__generated__ad_unit__DisplayPlacement:
      properties:
        ampren:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Ampren
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        clktype:
          default: 1
          maximum: 255
          minimum: 0
          title: Clktype
          type: integer
        context:
          anyOf:
            - $ref: '#/components/schemas/DisplayContext'
            - type: 'null'
        ctype:
          anyOf:
            - items:
                maximum: 255
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Ctype
        displayfmt:
          anyOf:
            - $ref: '#/components/schemas/DisplayFormat'
            - type: 'null'
        event:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventSpec'
              type: array
            - type: 'null'
          title: Event
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - type: number
            - type: 'null'
          title: H
        ifrbust:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Ifrbust
        mime:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Mime
        pos:
          anyOf:
            - $ref: '#/components/schemas/PlacementPosition'
            - type: 'null'
        priv:
          default: 0
          maximum: 255
          minimum: 0
          title: Priv
          type: integer
        ptype:
          anyOf:
            - $ref: '#/components/schemas/DisplayPlacementTypes'
            - type: 'null'
        topframe:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Topframe
        unit:
          default: 2
          maximum: 255
          minimum: 0
          title: Unit
          type: integer
        w:
          anyOf:
            - type: number
            - type: 'null'
          title: W
      title: DisplayPlacement
      type: object
    DataAssetRequest:
      properties:
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        len:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Len
        type:
          maximum: 65535
          minimum: 0
          title: Type
          type: integer
      required:
        - type
      title: DataAssetRequest
      type: object
    ImageAssetRequest:
      properties:
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: H
        hmin:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Hmin
        mimes:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Mimes
        type:
          anyOf:
            - maximum: 65535
              minimum: 0
              type: integer
            - type: 'null'
          title: Type
        w:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: W
        wmin:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Wmin
      title: ImageAssetRequest
      type: object
    IsRequired:
      enum:
        - 0
        - 1
      title: IsRequired
      type: integer
    TitleAssetRequest:
      properties:
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        len:
          minimum: 0
          title: Len
          type: integer
      required:
        - len
      title: TitleAssetRequest
      type: object
    VideoAssetRequest:
      properties:
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        linearity:
          anyOf:
            - $ref: '#/components/schemas/LinearityMode'
            - type: 'null'
        maxduration:
          minimum: 0
          title: Maxduration
          type: integer
        mimes:
          items:
            type: string
          title: Mimes
          type: array
        minduration:
          minimum: 0
          title: Minduration
          type: integer
        protocols:
          items:
            maximum: 65535
            minimum: 0
            type: integer
          title: Protocols
          type: array
      required:
        - maxduration
        - mimes
        - minduration
        - protocols
      title: VideoAssetRequest
      type: object
    Compare:
      properties:
        lhs:
          items:
            type: string
          title: Lhs
          type: array
        op:
          $ref: '#/components/schemas/Op'
        rhs:
          title: Rhs
      required:
        - lhs
        - op
        - rhs
      title: Compare
      type: object
    LinearityMode:
      enum:
        - 1
        - 2
      title: LinearityMode
      type: integer
    Op:
      enum:
        - eq
        - ne
        - lt
        - le
        - gt
        - ge
        - in
        - nin
      title: Op
      type: string
  securitySchemes:
    HTTPBearer:
      description: 'Bearer 인증. 액세스 토큰을 `Authorization: Bearer <token>` 헤더로 전달합니다.'
      scheme: bearer
      type: http

````