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.suggestSmartCampaignAd

Suggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and the business to advertise.

HTTP request

POST https://googleads.googleapis.com/v8/customers/{customerId}:suggestSmartCampaignAd

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the customer.

Request body

The request body contains data with the following structure:

JSON representation
{
  "suggestionInfo": {
    object (SmartCampaignSuggestionInfo)
  }
}
Fields
suggestionInfo

object (SmartCampaignSuggestionInfo)

Required. Inputs used to suggest a Smart campaign ad. Required fields: finalUrl, languageCode, keywordThemes. Optional but recommended fields to improve the quality of the suggestion: business_setting and geo_target.

Response body

If successful, the response body contains data with the following structure:

Response message for SmartCampaignSuggestService.SuggestSmartCampaignAd.

JSON representation
{
  "adInfo": {
    object (SmartCampaignAdInfo)
  }
}
Fields
adInfo

object (SmartCampaignAdInfo)

Optional. Ad info includes 3 creative headlines and 2 creative descriptions.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.