REST Resource: guaranteedOrders

資源：GuaranteedOrder

保證訂單。

保證訂單是保證廣告空間來源的上層實體。建立保證廣告空間來源時，必須為廣告空間來源指派保證訂單 ID。

JSON 表示法 
{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of mutually exclusive fields.
}
欄位
name

string

僅供輸出。保證訂單的資源名稱。
legacyGuaranteedOrderId

string

僅供輸出。保證訂單的舊版 ID。由原始廣告交易平台指派。舊版 ID 在單一廣告交易平台中是唯一的，但不保證在所有保證訂單中都是唯一的。這個 ID 會用於 SDF 和使用者介面。
exchange

enum (Exchange)

必填。不可變動。保證訂單來源的廣告交易平台。
guaranteedOrderId

string

僅供輸出。保證訂單的專屬 ID。保證訂單 ID 的格式為 {exchange}-{legacyGuaranteedOrderId}。
displayName

string

必填。保證訂單的顯示名稱。

必須採用 UTF-8 編碼，大小上限為 240 個位元組。
status

object (GuaranteedOrderStatus)

保證訂單的狀態設定。
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"。
publisherName

string

必填。保證訂單的發布商名稱。

必須採用 UTF-8 編碼，大小上限為 240 個位元組。
readAccessInherited

boolean

readWritePartnerId 的所有廣告主是否具備保證訂單的讀取權限。只有在設定 readWritePartnerId 時才適用。如果為 True，則會覆寫 readAdvertiserIds。
readAdvertiserIds[]

string (int64 format)

具備保證訂單讀取權限的廣告主 ID。

如果已設定，這個欄位不得包含指派給 readWriteAdvertiserId 的廣告主。這個欄位中的所有廣告主都必須屬於「readWritePartnerId」，或與「readWriteAdvertiserId」屬於同一個夥伴。
defaultAdvertiserId

string (int64 format)

僅供輸出。保證訂單的預設廣告主 ID。

預設廣告主為 readWriteAdvertiserId，如果未設定，則為 readAdvertiserIds 中列出的第一個廣告主。否則不會有預設廣告主。
defaultCampaignId

string (int64 format)

指派給保證訂單的預設廣告活動 ID。

預設廣告活動必須屬於預設廣告主。

必填。

對保證訂單具有讀取/寫入權限的夥伴或廣告主。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
readWritePartnerId

string (int64 format)

對保證訂單具有讀取/寫入權限的夥伴。
readWriteAdvertiserId

string (int64 format)

對保證訂單具有讀取/寫入權限的廣告主。這也是保證訂單的預設廣告主。
互斥欄位結束。

GuaranteedOrderStatus

保證訂單的狀態設定。

JSON 表示法 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
欄位
entityStatus

enum (EntityStatus)

保證訂單是否可放送。

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

string

使用者提供的暫停這筆保證訂單的原因。

必須採用 UTF-8 編碼，長度上限為 100 個位元組。

只有在 entityStatus 設為 ENTITY_STATUS_PAUSED 時才適用。
configStatus

enum (GuaranteedOrderConfigStatus)

僅供輸出。保證訂單的設定狀態。

可接受的值為 PENDING 和 COMPLETED。

保證訂單必須先完成設定 (填寫必填欄位、選擇廣告素材，以及選取預設廣告活動)，才能放送。目前只能透過使用者介面執行設定動作。

GuaranteedOrderConfigStatus

保證訂單可能出現的設定狀態。

列舉
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED 這個版本未指定或不清楚核准狀態。
PENDING 保證訂單的初始狀態。處於這個狀態的保證訂單必須先完成設定，才能放送。
COMPLETED 買家設定保證訂單後的狀態。

方法

create

 建立新的保證訂單。

editGuaranteedOrderReadAccessors

 編輯保證訂單的廣告主。

get

 取得保證訂單。

list

 列出目前使用者可存取的保證訂單。

patch

 更新現有的保證訂單。