テストのスケジュールを設定します。作成が成功すると、デザイン中のキャンペーンは実際のキャンペーン(テスト キャンペーン)に変換され、広告の配信が開始されます。
テストはすぐにスケジュールされ、ステータスが「INITIALIZING」になります。このメソッドは、デザイン キャンペーンのフォークを追跡する長時間実行オペレーションを返します。フォークが失敗した場合は、experiments.listExperimentAsyncErrors メソッドを使用してエラーのリストを取得できます。オペレーションのメタデータは、作成されたテストのリソース名を含む文字列になります。
スローされるエラーのリスト: AuthenticationError AuthorizationError ExperimentError DatabaseError DateError DateRangeError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP リクエスト
POST https://googleads.googleapis.com/v17/{resourceName=customers/*/experiments/*}:scheduleExperiment
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
resourceName |
必須。スケジュール設定されたテスト。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "validateOnly": boolean } |
フィールド | |
---|---|
validateOnly |
true の場合、リクエストは検証されますが、実行されません。結果ではなく、エラーのみが返されます。 |
レスポンスの本文
成功した場合、レスポンスの本文には Operation
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳しくは、OAuth 2.0 の概要をご覧ください。