REST Resource: sellers.adUnits

리소스: AdUnit

단일 광고 단위입니다.

JSON 표현 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "photoUris": [
    string
  ],
  "products": [
    string
  ]
}
필드
name

string

sellers/{seller}/adUnits/{adUnit} 형식으로 된 광고 단위의 리소스 이름입니다. 예: sellers/seller321/adUnits/adUnit123
externalId

string

판매자 관리 ID가 자체 시스템에 있는 것으로 보입니다. 일단 설정하면 변경될 가능성이 낮습니다.
displayName

string

필수 항목입니다. 광고 단위의 표시 이름입니다.

최대 240바이트의 UTF-8로 인코딩되어야 합니다.
description

string

광고 단위를 설명하는 추가 자유 형식 필드입니다.
labels

map (key: string, value: string)

이 광고 단위를 설명하는 자유 형식 라벨 집합입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
attributes[]

enum (AdUnitAttribute)

이 광고 단위를 더 자세히 정의하기 위한 속성입니다.
creatives[]

object (CreativeSpecification)

이 광고 단위에 게재할 수 있는 허용 가능한 광고 소재의 목록입니다. 이는 제품 수준에서도 정의할 수 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. 광고 단위의 생성 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 광고 단위의 최종 업데이트된 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (AdUnitState)

출력 전용입니다. 광고 단위의 상태입니다. AD_UNIT_STATE_REJECTED인 경우 deniedReason에 이유가 포함됩니다.
rejectedReason

string

출력 전용입니다. 승인 상태가 AD_UNIT_APPROVAL_STATUS_REJECTED인 경우 이 필드에 이유가 포함됩니다.
location

object (LatLng)

필수 항목입니다. 변경할 수 없습니다. 부호가 있는 도 형식으로 된 광고 단위의 위도와 경도입니다.
directionSet

boolean

true인 경우 방향 필드에 방향 값이 포함됩니다. false인 경우 방향이 0이어야 합니다.
direction

integer

변경할 수 없습니다. 기본 방향(도)이며 북쪽이 0을 나타냅니다. [0~360]입니다.
elevationMetersSet

boolean

true인 경우 고도 필드에 고도가 미터 단위로 포함됩니다. false인 경우 고도가 0이어야 합니다.
elevationMeters

number

변경할 수 없습니다. 광고 단위 하단에서 지면까지의 거리(미터)입니다.
physicalWidthMetersSet

boolean

true인 경우physicalWidthMeters 필드에 실제 너비가 미터 단위로 포함됩니다. false인 경우physicalWidthMeters는 0이어야 합니다.
physicalWidthMeters

number

변경할 수 없습니다. 광고 단위의 실제 너비(미터)입니다.
physicalHeightMetersSet

boolean

true인 경우physicalHeightMeters 필드에 실제 높이(미터)가 포함됩니다. false인 경우physicalHeightMeters가 0이어야 합니다.
physicalHeightMeters

number

변경할 수 없습니다. 광고 단위의 실제 높이(미터)입니다.
venue

enum (OutOfHomeVenue)

DPAA 표준을 기반으로 하는 옥외 이벤트 장소 유형입니다. 광고주에게 표시될 수 있고 광고 단위를 필터링하는 데 사용할 수도 있는 정보 필드입니다.
fixedLocation

boolean

광고가 고정된 위치 (빌보드)에 있는지 또는 이동 (택시)에 있는지를 나타냅니다.
indoors

boolean

필수 항목입니다. 광고 단위가 실내에 있는지 여부입니다.
photoUris[]

string

광고 단위의 사진 URI입니다.
products[]

string

필수 항목입니다. 이 광고 단위와 연결된 제품의 리소스 이름으로, sellers/{seller}/products/{product} 형식입니다. 예: sellers/seller111/products/product123

AdUnitAttribute

광고 단위를 추가로 정의하는 데 사용할 수 있는 속성입니다.

열거형
AD_UNIT_ATTRIBUTE_UNSPECIFIED 광고 단위 속성이 지정되지 않았거나 이 버전에서 알 수 없는 경우의 기본값입니다.
AD_UNIT_ATTRIBUTE_ILLUMINATED 광고 단위가 실제 세상에 있을 때 어둠 속에서도 볼 수 있는지 여부
AD_UNIT_ATTRIBUTE_DIGITAL 디지털 광고 단위가 포함되지 않은 경우 기존 실제 광고 단위가 암시됩니다.
AD_UNIT_ATTRIBUTE_PHYSICAL 광고 단위는 실제 세계에서 객체로 존재합니다.

AdUnitState

판매자의 관점에서 본 광고 단위의 상태입니다.

열거형
AD_UNIT_STATE_UNSPECIFIED 광고 단위 상태가 지정되지 않았거나 이 버전에서 알 수 없는 경우의 기본값입니다.
AD_UNIT_STATE_PENDING 광고 단위가 승인 대기 중입니다.
AD_UNIT_STATE_APPROVED 광고 단위가 승인되었습니다.
AD_UNIT_STATE_REJECTED 광고 단위가 거부되었습니다.
AD_UNIT_STATE_DELETED 광고 단위가 삭제되었습니다.

OutOfHomeVenue

DPAA 표준에 따른 옥외광고 장소 유형 목록입니다.

열거형
OOH_VENUE_UNSPECIFIED OOH 장소가 지정되지 않았거나 이 버전에서 알 수 없는 경우의 기본값입니다.
OOH_VENUE_AIRBORNE 옥외 공연장으로는 공중파로 분류됩니다.
OOH_VENUE_AIRPORTS_GENERAL 옥외 공연장은 일반 공항으로 분류됩니다.
OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM 공항 수하물 찾는 장소로 분류되는 옥외광고 장소입니다.
OOH_VENUE_AIRPORTS_TERMINAL 공항 터미널로 분류되는 옥외광고 장소입니다.
OOH_VENUE_AIRPORTS_LOUNGES 공항 라운지로 분류된 옥외 공간
OOH_VENUE_ATMS 옥외 매장이며 ATM으로 분류됩니다.
OOH_VENUE_BACKLIGHTS 옥외광고 장소는 백라이트로 분류됩니다.
OOH_VENUE_BARS 옥외 공연장으로는 바가 분류됩니다.
OOH_VENUE_BENCHES 옥외 스포츠 경기장은 벤치로 분류됩니다.
OOH_VENUE_BIKE_RACKS 자전거 랙으로 분류되는 옥외광고 장소입니다.
OOH_VENUE_BULLETINS 옥외광고 장소가 게시판으로 분류됩니다.
OOH_VENUE_BUSES 옥외광고 장소는 버스로 분류됩니다.
OOH_VENUE_CAFES 카페로 분류되는 옥외광고 장소입니다.
OOH_VENUE_CASUAL_DINING_RESTAURANTS 캐주얼한 식사 레스토랑으로 분류되는 옥외 음식점입니다.
OOH_VENUE_CHILD_CARE 옥외광고 장소는 보육원으로 분류되었습니다.
OOH_VENUE_CINEMA 영화관으로 분류된 옥외 공연장입니다.
OOH_VENUE_CITY_INFORMATION_PANELS 홈 옥외 장소는 도시 정보 패널로 분류됩니다.
OOH_VENUE_CONVENIENCE_STORES 편의점으로 분류되는 옥외광고 장소입니다.
OOH_VENUE_DEDICATED_WILD_POSTING 옥외광고 장소는 거친 전용 게시물로 분류됩니다.
OOH_VENUE_DOCTORS_OFFICES_GENERAL 옥외 진료실로 일반 진료소로 분류됩니다.
OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS 진료실 산과로 분류되는 옥외 장소입니다.
OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS 진료실 소아과로 분류되는 옥외 진료소입니다.
OOH_VENUE_FAMILY_ENTERTAINMENT 가족 엔터테인먼트로 분류된 옥외 공연장입니다.
OOH_VENUE_FERRIES 페리로 분류되는 옥외 여행지입니다.
OOH_VENUE_FINANCIAL_SERVICES 금융 서비스로 분류되는 옥외광고 장소입니다.
OOH_VENUE_GAS_STATIONS 주유소로 분류된 옥외 이벤트 장소입니다.
OOH_VENUE_GOLF_COURSES 골프 코스로 분류되는 홈 경기장입니다.
OOH_VENUE_GYMS 체육관으로 분류되는 옥외광고 시설입니다.
OOH_VENUE_HOSPITALS 옥외 진료실은 병원으로 분류됩니다.
OOH_VENUE_HOTELS 옥외광고 장소는 호텔로 분류됩니다.
OOH_VENUE_JUNIOR_POSTERS 주니어 포스터로 분류되는 옥외광고 장소입니다.
OOH_VENUE_KIOSKS 키오스크로 분류되는 옥외광고 장소입니다.
OOH_VENUE_MALLS_GENERAL 옥외광고 장소이며 일반 쇼핑몰로 분류됩니다.
OOH_VENUE_MALLS_FOOD_COURTS 쇼핑몰 푸드 코트로 분류되는 옥외광고 장소입니다.
OOH_VENUE_MARINE 해양 활동으로 분류되는 옥외 장소입니다.
OOH_VENUE_MOBILE_BILLBOARDS 옥외 광고판은 이동식 빌보드로 분류됩니다.
OOH_VENUE_MOVIE_THEATER_LOBBIES 영화관 로비로 분류되는 옥외 장소입니다.
OOH_VENUE_NEWSSTANDS 뉴스스탠드로 분류되는 옥외광고 장소입니다.
OOH_VENUE_OFFICE_BUILDINGS 옥외광고 장소는 사무실 건물로 분류됩니다.
OOH_VENUE_PHONE_KIOSKS 전화 키오스크로 분류되는 옥외광고 장소입니다.
OOH_VENUE_POSTERS 옥외광고 장소는 포스터로 분류됩니다.
OOH_VENUE_QSR QSR로 분류된 옥외 이벤트 장소
OOH_VENUE_RAIL 철도로 분류되는 옥외광고 장소입니다.
OOH_VENUE_RECEPTACLES 옥외광고 장소이며 실내용 용기로 분류됩니다.
OOH_VENUE_RESORTS 옥외 리조트로 리조트로 분류됩니다.
OOH_VENUE_RETAIL 옥외광고 장소가 소매업으로 분류됩니다.
OOH_VENUE_SALONS 미용실로 분류되는 옥외광고 시설입니다.
OOH_VENUE_SHELTERS 옥외 공간이며 대피소로 분류됩니다.
OOH_VENUE_SPORTS_ARENAS 스포츠 경기장으로 분류된 옥외 경기장입니다.
OOH_VENUE_SUBWAY 옥외 공연장으로 지하철로 분류됩니다.
OOH_VENUE_TAXIS 옥외광고 장소는 택시로 분류됩니다.
OOH_VENUE_TRUCKSIDE 옥외광고 장소는 트럭 옆으로 분류됩니다.
OOH_VENUE_UNIVERSITIES 대학으로 분류된 옥외 장소입니다.
OOH_VENUE_URBAN_PANELS 옥외 공연장은 도시 패널로 분류됩니다.
OOH_VENUE_VETERINARIAN_OFFICES 수의사 사무실로 분류된 옥외 장소입니다.
OOH_VENUE_WALLS 옥외 공연장은 벽으로 분류됩니다.
OOH_VENUE_OTHER 옥외광고 장소를 기타로 분류했습니다.

메서드

create

 새 광고 단위를 만듭니다.

delete

 기존 광고 단위를 삭제합니다.

get

 개별 광고 단위를 검색합니다.

list

 광고 단위를 나열합니다.

patch

 기존 광고 단위를 업데이트합니다.