資源:suredOrder
保證訂單。
保證訂單是保證廣告空間來源的上層實體。建立保證廣告空間來源時,必須指派保證訂單 ID 給廣告空間來源。
JSON 表示法 |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
欄位 | |
---|---|
name |
僅供輸出。保證訂單的資源名稱。 |
legacyGuaranteedOrderId |
僅供輸出。保證訂單的舊版 ID。由原始廣告交易平台指派。舊版 ID 在單一廣告交易平台中是獨一無二的,但不保證所有保證訂單都不得重複。這個 ID 會用於 SDF 和使用者介面。 |
exchange |
必要欄位。不可變動。保證訂單的來源廣告交易平台。 |
guaranteedOrderId |
僅供輸出。保證訂單的專屬 ID。保證訂單 ID 的格式為 |
displayName |
必要欄位。保證訂單的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
status |
保證訂單的狀態設定。 |
updateTime |
僅供輸出。保證訂單上次更新時的時間戳記。由系統指派。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
publisherName |
必要欄位。保證訂單的發布商名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
readAccessInherited |
|
readAdvertiserIds[] |
可讀取保證訂單的廣告主 ID。 這個欄位不得包含指派給 |
defaultAdvertiserId |
僅供輸出。保證訂單的預設廣告主 ID。 預設廣告主為 |
defaultCampaignId |
指派給保證訂單的預設廣告活動 ID。 預設廣告活動必須屬於預設廣告主。 |
聯集欄位 具有保證訂單讀取/寫入權限的夥伴或廣告主。 |
|
readWritePartnerId |
具備保證訂單讀取/寫入權限的合作夥伴。 |
readWriteAdvertiserId |
具有保證訂單讀取/寫入權限的廣告主。此外,這也是保證訂單的預設廣告主。 |
GuaranteedOrderStatus
保證訂單的狀態設定。
JSON 表示法 |
---|
{ "entityStatus": enum ( |
欄位 | |
---|---|
entityStatus |
保證訂單是否可用於放送。 可接受的值為 |
entityPauseReason |
使用者提供暫停這份保證訂單的原因。 必須以 UTF-8 編碼,長度上限為 100 個位元組。 只有在 |
configStatus |
僅供輸出。保證訂單的設定狀態。 可接受的值為 您必須設定保證訂單 (填寫必填欄位、選擇廣告素材並選取預設廣告活動),才能放送這類訂單。目前設定動作只能透過 UI 執行。 |
GuaranteedOrderConfigStatus
保證訂單的可能設定狀態。
列舉 | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
這個版本未指定或不明核准狀態。 |
PENDING |
保證訂單的起始狀態。您必須設定這個狀態的保證訂單,才能放送該狀態。 |
COMPLETED |
買方設定保證訂單後的狀態。 |
方法 |
|
---|---|
|
建立新的保證訂單。 |
|
編輯保證訂單的廣告主。 |
|
取得保證訂單。 |
|
列出目前使用者可存取的保證訂單。 |
|
更新現有的保證訂單。 |