<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Asks Google which keyword themes fit the app's landing page in the locations you picked, for a campaign you have not launched yet.

These come from Google's own read of the app's published site, so prefer them over the generated keyword_themes from Suggest Google Ads setup targeting and fill up from those. Send the language_code that endpoint returned, so Google answers in the same language.

The call always returns a 200 once it is allowed through. keyword_themes is empty when Google cannot answer: the app has no Google Ads account with a Google customer ID yet, the app is not published where Google can read it, none of geo_targets is a geo target constant ID, Google returns nothing, or the request to Google fails. Read an empty list as "keep the generated themes", not as an error. Nothing is saved, and no language model runs.

This is limited to 10 requests a minute per app. Some workspaces have a different limit. It is refused with a 409 while the workspace is on a Google Ads billing hold.

<Note>This endpoint accepts a personal API key from anyone who can edit the app. A read-only key is refused with a 403, and so are workspace API keys.</Note>

{
  "geo_targets": [
    "geoTargetConstants/1007339"
  ],
  "language_code": "en"
}

{
  "keyword_themes": [
    "phone repair shop",
    "screen replacement"
  ]
}