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

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

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

inventorySourceType

enum (InventorySourceType)

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

inventorySourceProductType

enum (InventorySourceProductType)

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

commitment

enum (InventorySourceCommitment)

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

deliveryMethod

enum (InventorySourceDeliveryMethod)

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

  • 미보장 인벤토리 소스의 경우 유일하게 사용 가능한 값은 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC입니다.
  • 보장 인벤토리 소스의 경우 허용되는 값은 INVENTORY_SOURCE_DELIVERY_METHOD_TAGINVENTORY_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입니다.

commitmentINVENTORY_SOURCE_COMMITMENT_GUARANTEED인 경우에만 적용됩니다.

readWriteAccessors

object (InventorySourceAccessors)

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

commitmentINVENTORY_SOURCE_COMMITMENT_GUARANTEED일 때만 출력됩니다. 이 경우 읽기/쓰기 접근자는 상위 보장 순서에서 상속됩니다.

commitmentINVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED인 경우 필수입니다.

commitmentINVENTORY_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자(영문 기준) 이하여야 합니다.

entityStatusENTITY_STATUS_PAUSED로 설정된 경우에만 적용됩니다.

sellerStatus

enum (EntityStatus)

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

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

sellerPauseReason

string

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

게시자로부터 직접 동기화되고 sellerStatusENTITY_STATUS_PAUSED로 설정된 인벤토리 소스에만 적용됩니다.

configStatus

enum (InventorySourceConfigStatus)

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

보장 인벤토리 소스에만 적용됩니다. 허용되는 값은 INVENTORY_SOURCE_CONFIG_STATUS_PENDINGINVENTORY_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)

디스플레이 광고 소재의 구성입니다. creativeTypeCREATIVE_TYPE_STANDARD인 경우 적용할 수 있습니다.

videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

동영상 광고 소재의 구성입니다. creativeTypeCREATIVE_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

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