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 인벤토리 소스는 프로그래매틱 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 요금 유형은 고정입니다.

Money

금액과 통화 유형을 나타냅니다.

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

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