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

{
  "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",
  "proximity": {
    "city": "Austin",
    "province": "Texas",
    "country": "US",
    "radius": 10,
    "radius_units": "miles"
  }
}