REST Resource: partners.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_TAG 및 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC입니다.
dealId

string

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

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

status

object (InventorySourceStatus)

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

exchange

enum (Exchange)

인벤토리 소스가 속한 거래소입니다.

updateTime

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

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입니다.

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

메서드

get

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

list

인벤토리 소스 거래를 나열합니다.