Method: customers.campaignDrafts.promote

下書きの変更を基本のキャンペーンにプロモートします。

このメソッドは、プロモートが完了したかどうかを示す長時間実行オペレーション（LRO）を返します。完了するまで [Operations.GetOperation] を使用して LRO をポーリングします。レスポンスで完了ステータスのみが返されます。キャンペーンの下書きリソースでステータスを確認し、プロモーションが成功したかどうかを判断します。LRO が失敗した場合は、CampaignDraftService.ListCampaignDraftAsyncErrors を使用してエラーの理由のリストを表示します。

スローされるエラーのリスト: AuthenticationError AuthorizationError CampaignDraftError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

POST https://googleads.googleapis.com/v15/{campaignDraft=customers/*/campaignDrafts/*}:promote

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
campaignDraft

string

必須。宣伝するキャンペーンの下書きのリソース名。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "validateOnly": boolean
}
フィールド
validateOnly

boolean

true の場合、リクエストは検証されますが、長時間実行オペレーションは作成されません。エラーのみが返されます。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/adwords

詳細については、OAuth 2.0 の概要をご覧ください。