Get Google Ads campaign targeting

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

Reads a campaign's current targeting from Google Ads: the themes it matches, the terms it excludes, and the locations on each side.

This reads Google directly rather than Base44's copy, so it is the authoritative set to seed an editor from. Send changes back with Update campaign.

Location entries carry a camel-cased resourceName, unlike the rest of this API. A location saved before Base44 recorded display names comes back with its numeric ID as name; nothing repairs that later, so resolve the label through Search locations if you need to show it.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

app_idstring required

ID of the app whose Google Ads campaigns to manage.

campaign_idstring required

Base44's ID for the campaign, as returned in id by List campaigns. This is not the Google Ads campaign ID, which is reported separately as google_campaign_id.

Response

The campaign's live targeting.

keyword_themesstring[] required

The themes the campaign matches on.

excluded_termsstring[] required

Search terms the campaign is told not to match.

language_codestring required

Two-letter code for the language the campaign advertises in. Defaults to en when the campaign has none set.

Example response

{
  "keyword_themes": [
    "handmade oak furniture",
    "custom dining tables"
  ],
  "excluded_terms": [
    "free",
    "repair"
  ],
  "targeted_locations": [
    {
      "name": "San Francisco",
      "resourceName": "geoTargetConstants/1014221"
    }
  ],
  "excluded_locations": [
    {
      "name": "Oakland",
      "resourceName": "geoTargetConstants/1014044"
    }
  ],
  "language_code": "en"
}

Get Google Ads campaign targeting

Path parameters

Response

Example response

Changes