- 資源:InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- 金額
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- 方法
資源:InventorySource
廣告空間來源。
JSON 表示法 |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
欄位 | |
---|---|
name |
僅供輸出。廣告空間來源的資源名稱。 |
inventorySourceId |
僅供輸出。廣告空間來源的專屬 ID。由系統指派。 |
displayName |
廣告空間來源的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
inventorySourceType |
這個欄位代表廣告空間來源的類型。 |
inventorySourceProductType |
僅供輸出。廣告空間來源的產品類型,表示銷售廣告空間的方式。 |
commitment |
廣告空間來源是否有保證或無保證放送。 |
deliveryMethod |
廣告空間來源的放送方式。
|
dealId |
廣告交易平台空間中專門用來識別廣告空間來源的 ID。 每個廣告交易平台中的買方 ID 不得重複,但不一定是每個廣告交易平台中的不重複值。 |
status |
廣告空間來源的狀態設定。 |
exchange |
廣告空間來源所屬的廣告交易平台。 |
updateTime |
僅供輸出。廣告空間來源上次更新時的時間戳記。由系統指派。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
rateDetails |
必要欄位。廣告空間來源的費率詳細資料。 |
publisherName |
廣告空間來源的發布商/賣方名稱。 |
timeRange |
這個廣告空間來源開始及停止放送的時間範圍。 |
creativeConfigs[] |
廣告空間來源的廣告素材規定。 不適用於競價套裝方案。 |
guaranteedOrderId |
不可變動。這個廣告空間來源所屬的保證訂單 ID。 僅適用於 |
readWriteAccessors |
具有廣告空間來源讀取/寫入權限的夥伴或廣告主。 僅在 當 如果 |
readAdvertiserIds[] |
僅供輸出。對廣告空間來源具備唯讀存取權的廣告主 ID。 |
readPartnerIds[] |
僅供輸出。對廣告空間來源具備唯讀存取權的合作夥伴 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 |
使用者提供暫停這個廣告空間來源的原因。 不得超過 100 個字元。 只有在 |
sellerStatus |
僅供輸出。賣方為廣告空間來源設定的狀態。 僅適用於直接與發布商同步的廣告空間來源。可接受的值為 |
sellerPauseReason |
僅供輸出。賣方提供的暫停這個廣告空間來源的原因。 僅適用於直接從發布商同步的廣告空間來源,且 |
configStatus |
僅供輸出。廣告空間來源的設定狀態。 僅適用於保證廣告空間來源。可接受的值為 必須先設定廣告空間來源 (填寫必填欄位、選擇廣告素材並選取預設廣告活動),才能將其放送。 |
InventorySourceConfigStatus
保證廣告空間來源的可能設定狀態。
列舉 | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
這個版本未指定或不明核准狀態。 |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
保證廣告空間來源的起始狀態。您必須設定這個狀態的廣告空間來源。 |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
買方設定保證廣告空間來源後的狀態。 |
RateDetails
廣告空間來源的費率相關設定。
JSON 表示法 |
---|
{ "inventorySourceRateType": enum ( |
欄位 | |
---|---|
inventorySourceRateType |
費率類型。 可接受的值為 |
rate |
廣告空間來源的費率, |
unitsPurchased |
對保證廣告空間來源而言,這是必要欄位。賣方保證的曝光次數。 |
minimumSpend |
僅供輸出。買方預先承諾在廣告空間來源上支付的金額。 僅適用於保證廣告空間來源。 |
InventorySourceRateType
廣告空間來源可能的費率類型。
列舉 | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
這個版本未指定或無法得知費率類型。 |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
費率類型為千次曝光出價 (固定)。 |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
費率類型是千次曝光出價 (底價)。 |
INVENTORY_SOURCE_RATE_TYPE_CPD |
費率的類型是「每日費用」。 |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
費率類型為「固定費率」。 |
金錢
代表金額與其貨幣類型。
JSON 表示法 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
欄位 | |
---|---|
currencyCode |
ISO 4217 所定義的三字母貨幣代碼。 |
units |
金額的整數單位。舉例來說,如果 |
nanos |
金額的 nano (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 |
TimeRange
時間範圍。
JSON 表示法 |
---|
{ "startTime": string, "endTime": string } |
欄位 | |
---|---|
startTime |
必要欄位。時間範圍的下限 (包括此值)。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
endTime |
必要欄位。時間範圍上限 (含)。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
CreativeConfig
廣告空間來源的廣告素材規定設定。
JSON 表示法 |
---|
{ "creativeType": enum ( |
欄位 | |
---|---|
creativeType |
可指派給廣告空間來源的廣告素材類型。僅支援以下類型:
|
聯集欄位
可指派給廣告空間來源的廣告素材設定。 |
|
displayCreativeConfig |
多媒體廣告素材的設定。適用於 |
videoCreativeConfig |
影片廣告素材設定。適用於 |
InventorySourceDisplayCreativeConfig
多媒體廣告素材的設定。
JSON 表示法 |
---|
{
"creativeSize": {
object ( |
欄位 | |
---|---|
creativeSize |
可指派給廣告空間來源的多媒體廣告素材大小規定。 |
InventorySourceVideoCreativeConfig
影片廣告素材設定。
JSON 表示法 |
---|
{ "duration": string } |
欄位 | |
---|---|
duration |
可指派給廣告空間來源的影片廣告素材時間長度規定。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
InventorySourceAccessors
可存取廣告空間來源的夥伴或廣告主。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 accessors 。可存取廣告空間來源的夥伴或廣告主。accessors 只能是下列其中一項: |
|
partner |
可存取廣告空間來源的合作夥伴。 |
advertisers |
可存取廣告空間來源的廣告客戶。所有廣告主都必須屬於相同的夥伴。 |
PartnerAccessor
可存取廣告空間來源的合作夥伴。
JSON 表示法 |
---|
{ "partnerId": string } |
欄位 | |
---|---|
partnerId |
合作夥伴的 ID。 |
AdvertiserAccessors
可存取廣告空間來源的廣告客戶。
JSON 表示法 |
---|
{ "advertiserIds": [ string ] } |
欄位 | |
---|---|
advertiserIds[] |
廣告客戶的 ID。 |
方法 |
|
---|---|
|
建立新的廣告空間來源。 |
|
編輯廣告空間來源的讀取/寫入存取子。 |
|
取得廣告空間來源。 |
|
列出目前使用者可存取的廣告空間來源。 |
|
更新現有的廣告空間來源。 |