Sign in
Ad Campaigns

Read a Google campaign's device, location, and language targeting

Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.

devices lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. bidModifier is Google's bid adjustment for that device, null when it has none, and 0 when the device is switched off; included is false for exactly that case.

get/v1/ads/campaigns/{campaignId}/targeting

Path parameters

campaignIdstring required

Google platform campaign ID

Query parameters

platform'google'

Disambiguates when the same campaignId string exists on more than one connected platform.

Response

Current campaign targeting

cachedAtstring date-time nullable

When this targeting was fetched from Google. Null when it was never served from cache.

staleboolean

True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

Changes