CampaignDraft

廣告活動草稿。

JSON 表示法
{
  "resourceName": string,
  "status": enum (CampaignDraftStatus),
  "draftId": string,
  "baseCampaign": string,
  "name": string,
  "draftCampaign": string,
  "hasExperimentRunning": boolean,
  "longRunningOperation": string
}
欄位
resourceName

string

無法變更。廣告活動草稿的資源名稱。廣告活動草稿資源名稱的格式為:

customers/{customerId}/campaignDrafts/{base_campaign_id}~{draftId}

status

enum (CampaignDraftStatus)

僅供輸出。廣告活動草稿的狀態。這是唯讀欄位。

新增廣告活動草稿後,狀態會預設為「PROPOSED」。

draftId

string (int64 format)

僅供輸出。草稿的 ID。

這是唯讀欄位。

baseCampaign

string

無法變更。草稿所屬的基礎廣告活動。

name

string

廣告活動草稿的名稱。

這是必填欄位,而且在建立新的廣告活動草稿時,該欄位不可空白。

而且不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。

draftCampaign

string

僅供輸出。因將草稿變更套用到基礎廣告活動而產生的廣告活動資源名稱。

這是唯讀欄位。

hasExperimentRunning

boolean

僅供輸出。是否有根據這個草稿運作的實驗。

longRunningOperation

string

僅供輸出。長時間執行作業的資源名稱,可用來輪詢促銷活動草稿是否完成。只有在促銷活動草稿正在進行中或已完成時,才需要設定這個選項。

CampaignDraftStatus

廣告活動草稿可能的狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
PROPOSED 草稿的初始狀態,廣告客戶可以開始新增變更,不會影響放送。
REMOVED 已移除廣告活動草稿。
PROMOTING 廣告主要求將草稿變更推送回原始廣告活動。廣告主可以輪詢動作傳回的長時間執行作業,查看促銷活動的狀態。
PROMOTED 將草稿中的變更合併回原始廣告活動的程序已順利完成。
PROMOTE_FAILED 促銷活動未部分套用後失敗。無法以安全的方式再次嘗試宣傳,因此必須在原始廣告活動中修正問題。