- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- AdGroupKeywordSuggestion
- UnusableAdGroup
- Try it!
Returns a list of suggested AdGroups and suggested modifications (text, match type) for the given keywords.
List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP request
POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAdGroupThemes
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
customerId |
Required. The ID of the customer. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
Fields | |
---|---|
keywords[] |
Required. A list of keywords to group into the provided AdGroups. |
adGroups[] |
Required. A list of resource names of AdGroups to group keywords into. Resource name format: |
Response body
Response message for KeywordPlanIdeaService.GenerateAdGroupThemes
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
Fields | |
---|---|
adGroupKeywordSuggestions[] |
A list of suggested AdGroup/keyword pairings. |
unusableAdGroups[] |
A list of provided AdGroups that could not be used as suggestions. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adwords
For more information, see the OAuth 2.0 Overview.
AdGroupKeywordSuggestion
The suggested text and AdGroup/Campaign pairing for a given keyword.
JSON representation |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
Fields | |
---|---|
keywordText |
The original keyword text. |
suggestedKeywordText |
The normalized version of keywordText for BROAD/EXACT/PHRASE suggestions. |
suggestedMatchType |
The suggested keyword match type. |
suggestedAdGroup |
The suggested AdGroup for the keyword. Resource name format: |
suggestedCampaign |
The suggested Campaign for the keyword. Resource name format: |
UnusableAdGroup
An AdGroup/Campaign pair that could not be used as a suggestion for keywords.
AdGroups may not be usable if the AdGroup
- belongs to a Campaign that is not ENABLED or PAUSED
- is itself not ENABLED
JSON representation |
---|
{ "adGroup": string, "campaign": string } |
Fields | |
---|---|
adGroup |
The AdGroup resource name. Resource name format: |
campaign |
The Campaign resource name. Resource name format: |