排定實驗時間。的設計廣告活動會轉換為實際廣告活動 (稱為實驗廣告活動),如果成功建立,就會開始放送廣告。
實驗會立即排定,狀態為「INITIALIZING」。這個方法會傳回長時間執行的作業,追蹤設計廣告活動中的 分支。如果建立作業失敗,可使用 experiment.listExperimentAsyncErrors 方法擷取錯誤清單。作業的中繼資料會是含有所建立實驗資源名稱的字串。
擲回錯誤清單:AuthenticationError AuthorizationError ExperimentError DatabaseError DateError DateRangeError FieldError HeaderError InternalError QuotaError RangeError RangeError RangeError RangeError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v14/{resourceName=customers/*/experiments/*}:scheduleExperiment
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
resourceName |
必要欄位。已排定的實驗。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "validateOnly": boolean } |
欄位 | |
---|---|
validateOnly |
如果為 true,則驗證要求但尚未執行。系統只會傳回錯誤,而非傳回結果。 |
回應主體
如果成功,回應主體會包含 Operation
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。