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

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

必須採用 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。

在每個廣告交易平台中，買家 ID 不得重複，但不同廣告交易平台之間的買家 ID 可以重複。
status

object (InventorySourceStatus)

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

enum (Exchange)

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

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「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

 列出廣告空間來源交易。