REST Resource: inventorySources

리소스: InventorySource

인벤토리 소스

JSON 표현 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
입력란
name

string

출력 전용. 인벤토리 소스의 리소스 이름입니다.
inventorySourceId

string (int64 format)

출력 전용. 인벤토리 소스의 고유 ID입니다. 시스템에서 할당합니다.
displayName

string

인벤토리 소스의 표시 이름입니다.

UTF-8 형식으로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다.
inventorySourceType

enum (InventorySourceType)

인벤토리 소스의 유형을 나타냅니다.
inventorySourceProductType

enum (InventorySourceProductType)

출력 전용. 인벤토리 판매 방법을 나타내는 인벤토리 소스의 제품 유형입니다.
commitment

enum (InventorySourceCommitment)

인벤토리 소스의 게재가 보장 또는 미보장인지 여부입니다.
deliveryMethod

enum (InventorySourceDeliveryMethod)

인벤토리 소스의 게재 방법입니다.

  • 미보장 인벤토리 소스의 경우 허용되는 값은 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC뿐입니다.
  • 보장 인벤토리 소스의 경우 허용되는 값은 INVENTORY_SOURCE_DELIVERY_METHOD_TAG 및 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC입니다.
dealId

string

인벤토리 소스를 고유하게 식별하는 거래소 공간의 ID입니다.

각 광고 거래소 내 구매자별로 고유해야 하지만, 광고 거래소 간에 고유할 필요는 없습니다.
status

object (InventorySourceStatus)

인벤토리 소스의 상태 설정입니다.
exchange

enum (Exchange)

인벤토리 소스가 속한 교환입니다.
updateTime

string (Timestamp format)

출력 전용. 인벤토리 소스가 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다.

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

object (RateDetails)

필수 항목입니다. 인벤토리 소스의 요금 세부정보입니다.
publisherName

string

인벤토리 소스의 게시자/판매자 이름입니다.
timeRange

object (TimeRange)

이 인벤토리 소스가 게재를 시작하고 중지하는 시간 범위입니다.
creativeConfigs[]

object (CreativeConfig)

인벤토리 소스의 광고 소재 요구사항

입찰 패키지에는 적용되지 않습니다.
guaranteedOrderId

string

변경할 수 없습니다. 이 인벤토리 소스가 속한 보장 주문의 ID입니다.

commitment이 INVENTORY_SOURCE_COMMITMENT_GUARANTEED인 경우에만 적용됩니다.
readWriteAccessors

object (InventorySourceAccessors)

인벤토리 소스에 대한 읽기/쓰기 액세스 권한이 있는 파트너 또는 광고주입니다.

commitment가 INVENTORY_SOURCE_COMMITMENT_GUARANTEED인 경우에만 출력합니다. 이 경우 읽기/쓰기 접근자는 상위 보장 순서에서 상속됩니다.

commitment이 INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED인 경우 필수입니다.

commitment이 INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED이고 이 필드에 파트너가 설정되어 있는 경우 이 파트너의 모든 광고주는 자동으로 인벤토리 소스에 대한 읽기 전용 액세스 권한을 갖게 됩니다. 이러한 광고주는 readAdvertiserIds에 포함되지 않습니다.
readAdvertiserIds[]

string (int64 format)

출력 전용. 인벤토리 소스에 대한 읽기 전용 액세스 권한이 있는 광고주의 ID입니다.
readPartnerIds[]

string (int64 format)

출력 전용. 인벤토리 소스에 대한 읽기 전용 액세스 권한이 있는 파트너의 ID입니다.

이 필드의 파트너의 모든 광고주는 인벤토리 소스에 대한 읽기 전용 액세스 권한을 상속받습니다.

InventorySourceType

가능한 인벤토리 소스 유형입니다.

열거형
INVENTORY_SOURCE_TYPE_UNSPECIFIED 이 버전에서 인벤토리 소스 유형이 지정되지 않았거나 알 수 없습니다.
INVENTORY_SOURCE_TYPE_PRIVATE 비공개 인벤토리 소스
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE 입찰 패키지

InventorySourceProductType

인벤토리 소스의 가능한 제품 유형입니다.

열거형
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED 이 버전에서 제품 유형이 지정되지 않았거나 알 수 없습니다. 이 제품 유형의 인벤토리 소스 수정은 API를 통해 지원되지 않습니다.
PREFERRED_DEAL 인벤토리 소스는 우선 거래를 통해 인벤토리를 판매합니다.
PRIVATE_AUCTION 인벤토리 소스는 비공개 입찰을 통해 인벤토리를 판매합니다.
PROGRAMMATIC_GUARANTEED 인벤토리 소스는 보장 프로그래매틱을 통해 인벤토리를 판매합니다.
TAG_GUARANTEED 인벤토리 소스가 태그 보장을 통해 인벤토리를 판매합니다.
YOUTUBE_RESERVE 인벤토리 소스는 YouTube Reserve를 통해 인벤토리를 판매합니다.
INSTANT_RESERVE 인벤토리 소스는 빠른 예약을 통해 인벤토리를 판매합니다. 이 제품 유형의 인벤토리 소스 수정은 API를 통해 지원되지 않습니다.
GUARANTEED_PACKAGE 인벤토리 소스는 보장된 패키지를 통해 인벤토리를 판매합니다. 이 제품 유형의 인벤토리 소스 수정은 API를 통해 지원되지 않습니다.
PROGRAMMATIC_TV 인벤토리 소스는 Programmtic TV를 통해 인벤토리를 판매합니다. 이 제품 유형의 인벤토리 소스 수정은 API를 통해 지원되지 않습니다.
AUCTION_PACKAGE 인벤토리 소스는 입찰 패키지를 통해 인벤토리를 판매합니다. 이 제품 유형의 인벤토리 소스 수정은 API를 통해 지원되지 않습니다.

InventorySourceCommitment

인벤토리 소스에 가능한 약정 유형입니다.

열거형
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED 이 버전에서 약정이 지정되지 않았거나 알 수 없습니다.
INVENTORY_SOURCE_COMMITMENT_GUARANTEED 약정은 전달이 보장됩니다.
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED 약정은 미보장 배송입니다.

InventorySourceDeliveryMethod

인벤토리 소스에 사용할 수 있는 게재 방법입니다.

열거형
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED 이 버전에서 게재 방법이 지정되지 않았거나 알 수 없습니다.
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC 게재 방법이 프로그래매틱입니다.
INVENTORY_SOURCE_DELIVERY_METHOD_TAG 게재 방법은 태그입니다.

InventorySourceStatus

인벤토리 소스의 상태 관련 설정입니다.

JSON 표현 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}
입력란
entityStatus

enum (EntityStatus)

인벤토리 소스의 게재 가능 여부입니다.

허용되는 값은 ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED, ENTITY_STATUS_PAUSED입니다. 기본값은 ENTITY_STATUS_ACTIVE입니다.
entityPauseReason

string

사용자가 이 인벤토리 소스를 일시중지하는 이유입니다.

100자(영문 기준) 이하여야 합니다.

entityStatus가 ENTITY_STATUS_PAUSED로 설정된 경우에만 적용됩니다.
sellerStatus

enum (EntityStatus)

출력 전용. 판매자가 인벤토리 소스에 대해 설정한 상태입니다.

게시자로부터 직접 동기화된 인벤토리 소스에만 적용됩니다. 허용되는 값은 ENTITY_STATUS_ACTIVE 및 ENTITY_STATUS_PAUSED입니다.
sellerPauseReason

string

출력 전용. 판매자가 이 인벤토리 소스를 일시중지하는 이유를 제공합니다.

sellerStatus가 ENTITY_STATUS_PAUSED로 설정된 경우 게시자에서 직접 동기화되는 인벤토리 소스에만 적용됩니다.
configStatus

enum (InventorySourceConfigStatus)

출력 전용. 인벤토리 소스의 구성 상태입니다.

보장 인벤토리 소스에만 적용됩니다. 허용되는 값은 INVENTORY_SOURCE_CONFIG_STATUS_PENDING 및 INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED입니다.

인벤토리 소스를 구성 (필수 입력란 작성, 광고 소재 선택, 기본 캠페인 선택)해야 게재할 수 있습니다.

InventorySourceConfigStatus

보장 인벤토리 소스에 가능한 구성 상태입니다.

열거형
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED 이 버전에서 승인 상태가 지정되지 않았거나 알 수 없습니다.
INVENTORY_SOURCE_CONFIG_STATUS_PENDING 보장 인벤토리 소스의 시작 상태입니다. 이 상태의 인벤토리 소스를 구성해야 합니다.
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED 구매자가 보장 인벤토리 소스를 구성한 후의 상태입니다.

RateDetails

인벤토리 소스의 요금 관련 설정입니다.

JSON 표현 
{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}
입력란
inventorySourceRateType

enum (InventorySourceRateType)

요율 유형입니다.

허용되는 값은 INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR, INVENTORY_SOURCE_RATE_TYPE_CPD입니다.
rate

object (Money)

인벤토리 소스의 요율입니다.
unitsPurchased

string (int64 format)

보장 인벤토리 소스의 경우 필수입니다. 판매자가 보장하는 노출수입니다.
minimumSpend

object (Money)

출력 전용. 구매자가 인벤토리 소스에 선불로 지출하기로 약정한 금액입니다.

보장 인벤토리 소스에만 적용됩니다.

InventorySourceRateType

인벤토리 소스에 사용 가능한 요율 유형입니다.

열거형
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED 요율 유형이 지정되지 않았거나 이 버전에서 알 수 없습니다.
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED 요율 유형은 CPM (고정)입니다.
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR 요율 유형은 CPM (최저)입니다.
INVENTORY_SOURCE_RATE_TYPE_CPD 요율 유형은 일일 비용입니다.
INVENTORY_SOURCE_RATE_TYPE_FLAT 요율 유형은 고정입니다.

돈

해당 통화 유형의 금액을 나타냅니다.

JSON 표현 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
입력란
currencyCode

string

ISO 4217에 정의된 3자리 통화 코드입니다.
units

string (int64 format)

금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 1달러(USD)입니다.
nanos

integer

금액의 나노 (10^-9) 단위 수입니다. 값은 -999,999,999 ~ +999,999,999(포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수가 될 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1, nanos=-750,000,000으로 나타냅니다.

TimeRange

시간 범위.

JSON 표현 
{
  "startTime": string,
  "endTime": string
}
입력란
startTime

string (Timestamp format)

필수 항목입니다. 시간 범위의 하한(포함)입니다.

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

string (Timestamp format)

필수 항목입니다. 시간 범위의 상한(양 끝값 포함)입니다.

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

CreativeConfig

인벤토리 소스의 광고 소재 요구사항 구성입니다.

JSON 표현 
{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}
입력란
creativeType

enum (CreativeType)

인벤토리 소스에 할당할 수 있는 광고 소재의 유형입니다. 다음 유형만 지원됩니다.

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

통합 필드 creative_config_scheme. creative_type이 다음 중 하나일 때 적용됩니다.

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

인벤토리 소스에 할당할 수 있는 광고 소재의 구성입니다. creative_config_scheme는 다음 중 하나여야 합니다.
displayCreativeConfig

object (InventorySourceDisplayCreativeConfig)

디스플레이 광고 소재의 구성입니다. creativeType가 CREATIVE_TYPE_STANDARD일 때 적용할 수 있습니다.
videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

동영상 광고 소재의 구성입니다. creativeType가 CREATIVE_TYPE_VIDEO일 때 적용할 수 있습니다.

InventorySourceDisplayCreativeConfig

디스플레이 광고 소재의 구성입니다.

JSON 표현 
{
  "creativeSize": {
    object (Dimensions)
  }
}
입력란
creativeSize

object (Dimensions)

인벤토리 소스에 할당할 수 있는 디스플레이 광고 소재의 크기 요구사항입니다.

InventorySourceVideoCreativeConfig

동영상 광고 소재의 구성입니다.

JSON 표현 
{
  "duration": string
}
입력란
duration

string (Duration format)

인벤토리 소스에 할당할 수 있는 동영상 광고 소재의 재생 시간 요구사항입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

InventorySourceAccessors

인벤토리 소스에 액세스할 수 있는 파트너 또는 광고주입니다.

JSON 표현 
{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}
입력란
통합 필드 accessors. 인벤토리 소스에 액세스할 수 있는 파트너 또는 광고주입니다. accessors은 다음 중 하나여야 합니다.
partner

object (PartnerAccessor)

인벤토리 소스에 액세스할 수 있는 파트너입니다.
advertisers

object (AdvertiserAccessors)

인벤토리 소스에 액세스할 수 있는 광고주 모든 광고주는 동일한 파트너에 속해 있어야 합니다.

PartnerAccessor

인벤토리 소스에 액세스할 수 있는 파트너입니다.

JSON 표현 
{
  "partnerId": string
}
입력란
partnerId

string (int64 format)

파트너의 ID입니다.

AdvertiserAccessors

인벤토리 소스에 액세스할 수 있는 광고주

JSON 표현 
{
  "advertiserIds": [
    string
  ]
}
입력란
advertiserIds[]

string (int64 format)

광고주의 ID입니다.

방법

create

 새 인벤토리 소스를 생성합니다.

editInventorySourceReadWriteAccessors

 인벤토리 소스의 읽기/쓰기 접근자를 수정합니다.

get

 인벤토리 소스를 가져옵니다.

list

 현재 사용자가 액세스할 수 있는 인벤토리 소스를 나열합니다.

patch

 기존 인벤토리 소스를 업데이트합니다.