Edit a Google campaign's device, location, excluded location, or language targeting

Changes a Google campaign's device, location, excluded location or language targeting after it was created.

Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of devices, locations, excludedLocations, languages, locationTargetingType; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.

devices is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.

locations accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with countries/regions/cities/zips/metros key lists (key from GET /v1/ads/targeting/search?dimension=geo). Excluded locations are left untouched by locations. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit locations to leave targeting alone.

excludedLocations takes the same two shapes and replaces the campaign's negative location criteria (the places it never serves in), leaving the targeted locations untouched. An empty list (or {}) removes every exclusion. Radius exclusions are not supported. A place cannot be both targeted and excluded: a request whose result would leave one on both sides returns 400 before anything is written, and moving a place from one side to the other in the same request is applied atomically. Example: { "platform": "google", "targeting": { "excludedLocations": { "countries": ["CA"], "regions": ["21137"] } } }.

The removes and the creates go out in ONE Google googleAds:mutate, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.

languages is an array of Google's language codes (ISO 639-1, plus variants such as zh_CN); an unknown code returns 400.

locationTargetingType switches who the location targeting reaches: presence (people in or regularly in the locations) or presence_or_interest (also people searching for or interested in them). Example: { "platform": "google", "targeting": { "locationTargetingType": "presence" } }.

The response includes the refreshed devices/locations/excludedLocations/languages state read back from Google after the edit, and invalidates the cached copy GET on this campaign would otherwise keep serving.

Demand Gen: Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its adGroupId (the campaign-level locations/languages read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} targeting on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. devices and locationTargetingType stay campaign-level. excludedLocations is not available on Demand Gen yet and returns 400.

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcampaigns.updateCampaignTargeting({  path: {    campaignId: 'campaign_abc123',  },  body: {    platform: 'google',    targeting: {      devices: [        'MOBILE',      ],      locations: [        'string',      ],      languages: [        'string',      ],    },  },});console.log(data);

{  "campaignId": "string",  "adGroupId": "string",  "updated": [    "devices"  ],  "locationTargetingType": "presence",  "devices": [    {      "device": "MOBILE",      "included": true,      "bidModifier": 0    }  ],  "locations": [    {      "geoTargetId": "string",      "negative": true,      "name": "string",      "canonicalName": "string",      "type": "string",      "countryCode": "string"    }  ],  "excludedLocations": [    {      "geoTargetId": "string",      "negative": true,      "name": "string",      "canonicalName": "string",      "type": "string",      "countryCode": "string"    }  ],  "languages": [    {      "code": "string",      "id": "string",      "name": "string"    }  ]}