REST Resource: inventorySources

{
  "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
  ]
}

string

僅供輸出。廣告空間來源的資源名稱。

string (int64 format)

僅供輸出。廣告空間來源的專屬 ID。由系統指派。

string

廣告空間來源的顯示名稱。

必須是 UTF-8 編碼，且長度上限為 240 個位元組。

enum (InventorySourceType)

代表廣告空間來源的類型。

enum (InventorySourceProductType)

僅供輸出。廣告空間來源的產品類型，指出廣告空間銷售方式。

enum (InventorySourceCommitment)

廣告空間來源是否有保證或無保證放送。

enum (InventorySourceDeliveryMethod)

廣告空間來源的放送方式。

• 如果是無保證廣告空間來源，唯一接受的值為 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC。
• 對於保證廣告空間來源，可接受的值為 INVENTORY_SOURCE_DELIVERY_METHOD_TAG 和 INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC。

string

廣告交易平台空間中，用來識別廣告空間來源的專屬 ID。

每個廣告交易平台的所有買方 ID 都不得重複，但不一定要是每個廣告交易平台的買方。

object (InventorySourceStatus)

廣告空間來源的狀態設定。

enum (Exchange)

廣告空間來源所屬的廣告交易平台。

string (Timestamp format)

僅供輸出。廣告空間來源上次更新時間的時間戳記。由系統指派。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (RateDetails)

必要欄位。廣告空間來源的費率詳細資料。

string

廣告空間來源的發布商/賣方名稱。

object (TimeRange)

這個廣告空間來源開始及停止放送的時間範圍。

object (CreativeConfig)

廣告空間來源的廣告素材相關規定。

不適用於競價套裝方案。

string

不可變動。這個廣告空間來源所屬的保證訂單 ID。

只有在 commitment 為 INVENTORY_SOURCE_COMMITMENT_GUARANTEED 時才能使用。

object (InventorySourceAccessors)

擁有廣告空間來源讀取/寫入權限的夥伴或廣告主。

只有在 commitment 為 INVENTORY_SOURCE_COMMITMENT_GUARANTEED 時才會輸出，這時讀取/寫入存取子會沿用父項保證順序。

如果 commitment 為 INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED，則為必要欄位。

如果 commitment 為「INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED」且這個欄位已設定合作夥伴，則這個夥伴中的所有廣告客戶都將自動具備廣告空間來源的唯讀存取權。這些廣告主將不會納入「readAdvertiserIds」。

string (int64 format)

僅供輸出。具備廣告空間來源唯讀存取權的廣告主 ID。

string (int64 format)

僅供輸出。具備廣告空間來源唯讀存取權的合作夥伴 ID。

這個欄位中的夥伴的所有廣告主都會沿用廣告空間來源的唯讀存取權。

{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}

enum (EntityStatus)

廣告空間來源是否可放送。

可接受的值為 ENTITY_STATUS_ACTIVE、ENTITY_STATUS_ARCHIVED 和 ENTITY_STATUS_PAUSED。預設值為 ENTITY_STATUS_ACTIVE。

string

使用者提供暫停這個廣告空間來源的原因。

不得超過 100 個半形字元。

只有在 entityStatus 設為 ENTITY_STATUS_PAUSED 時才能使用。

enum (EntityStatus)

僅供輸出。賣方為廣告空間來源設定的狀態。

僅適用於直接從發布商同步的廣告空間來源。可接受的值為 ENTITY_STATUS_ACTIVE 和 ENTITY_STATUS_PAUSED。

string

僅供輸出。賣方提供暫停這個廣告空間來源的原因。

僅適用於直接與發布商同步，且 sellerStatus 設為 ENTITY_STATUS_PAUSED 的廣告空間來源。

enum (InventorySourceConfigStatus)

僅供輸出。廣告空間來源的設定狀態。

僅適用於保證廣告空間來源。可接受的值為 INVENTORY_SOURCE_CONFIG_STATUS_PENDING 和 INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED。

您必須先設定廣告空間來源 (填寫必填欄位、選擇廣告素材並選取預設廣告活動)，才能放送廣告空間來源。

{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}

enum (InventorySourceRateType)

費率類型。

可接受的值為 INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED、INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR 和 INVENTORY_SOURCE_RATE_TYPE_CPD。

object (Money)

廣告空間來源的費率。

string (int64 format)

保證廣告空間來源必填。賣方保證的曝光次數。

object (Money)

僅供輸出。買方承諾為廣告空間來源支出的金額。

僅適用於保證廣告空間來源。

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217 定義的貨幣代碼 (由三個字母表示)。

string (int64 format)

金額的整數單位。舉例來說，如果 currencyCode 是 "USD"，則 1 單位為一美元。

integer

金額的十億分之一 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 units 為正數，nanos 必須為正數或零。如果 units 為零，nanos 可以是正數、零或負數。如果 units 為負數，nanos 必須為負數或零。例如 $-1.75 美元的呈現方式為 units=-1 和 nanos=-750,000,000。

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

必要欄位。時間範圍的下限 (含頭尾)。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

必要欄位。時間範圍的上限 (含頭尾)。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "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.
}

enum (CreativeType)

可指派給廣告空間來源的廣告素材類型。系統僅支援以下類型：

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

多媒體廣告素材的設定。當 creativeType 為 CREATIVE_TYPE_STANDARD 時適用。

object (InventorySourceVideoCreativeConfig)

影片廣告素材的設定。當 creativeType 為 CREATIVE_TYPE_VIDEO 時適用。

{
  "creativeSize": {
    object (Dimensions)
  }
}

object (Dimensions)

可指派給廣告空間來源的多媒體廣告素材大小規定。

{
  "duration": string
}

string (Duration format)

可指派給廣告空間來源的影片廣告素材時間長度規定。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

{

  // 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.
}

object (PartnerAccessor)

有權存取廣告空間來源的合作夥伴。

object (AdvertiserAccessors)

可存取廣告空間來源的廣告主。所有廣告主都必須屬於同一個夥伴。

{
  "partnerId": string
}

string (int64 format)

合作夥伴的 ID。

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

廣告客戶的 ID。