Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Method: customers.campaignDrafts.promote

Promotes the changes in a draft back to the base campaign.

This method returns a Long Running Operation (LRO) indicating if the Promote is done. Use [Operations.GetOperation] to poll the LRO until it is done. Only a done status is returned in the response. See the status in the Campaign Draft resource to determine if the promotion was successful. If the LRO failed, use CampaignDraftService.ListCampaignDraftAsyncErrors to view the list of error reasons.

List of thrown errors: AuthenticationError AuthorizationError CampaignDraftError HeaderError InternalError QuotaError RequestError

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
campaignDraft

string

Required. The resource name of the campaign draft to promote.

Request body

The request body contains data with the following structure:

JSON representation
{
  "validateOnly": boolean
}
Fields
validateOnly

boolean

If true, the request is validated but no Long Running Operation is created. Only errors are returned.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.