---
title: "POST /v23/customers/{customersId}:generateAdGroupThemes"
method: POST
path: "/v23/customers/{customersId}:generateAdGroupThemes"
tags: ["customers"]
---

# POST /v23/customers/{customersId}:generateAdGroupThemes

`POST /v23/customers/{customersId}:generateAdGroupThemes`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{customersId}:generateAdGroupThemes`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/doubleclicksearch`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch`
- TypeScript: <https://skmtc.dev/google/apis/searchads360/docs/v23/customers/:customersId:generateAdGroupThemes/post.ts> (a function with typed inputs; its response is checked against the schema)

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]()

## Path parameters

- `customersId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesGenerateAdGroupThemesRequest: Request message for KeywordPlanIdeaService.GenerateAdGroupThemes.
  - `adGroups` string[]: Required. A list of resource names of AdGroups to group keywords into. Resource name format: `customers/{customer_id}/adGroups/{ad_group_id}`
  - `keywords` string[]: Required. A list of keywords to group into the provided AdGroups.

## Response `200`

Successful response

- GoogleAdsSearchads360V23ServicesGenerateAdGroupThemesResponse: Response message for KeywordPlanIdeaService.GenerateAdGroupThemes.
  - `adGroupKeywordSuggestions` GoogleAdsSearchads360V23ServicesAdGroupKeywordSuggestion[]: A list of suggested AdGroup/keyword pairings.
    - `keywordText` string: The original keyword text.
    - `suggestedAdGroup` string: The suggested AdGroup for the keyword. Resource name format: `customers/{customer_id}/adGroups/{ad_group_id}`
    - `suggestedCampaign` string: The suggested Campaign for the keyword. Resource name format: `customers/{customer_id}/campaigns/{campaign_id}`
    - `suggestedKeywordText` string: The normalized version of keyword_text for BROAD/EXACT/PHRASE suggestions.
    - `suggestedMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD': The suggested keyword match type.
  - `unusableAdGroups` GoogleAdsSearchads360V23ServicesUnusableAdGroup[]: A list of provided AdGroups that could not be used as suggestions.
    - `adGroup` string: The AdGroup resource name. Resource name format: `customers/{customer_id}/adGroups/{ad_group_id}`
    - `campaign` string: The Campaign resource name. Resource name format: `customers/{customer_id}/campaigns/{campaign_id}`

---

[API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)