Skip to main content
Google AdsVersion: v3

Search targeting options

GET/ad-publishing/google/targeting/search

Search Google geo-locations for ad targeting

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

typestringrequired

Search type

Available optionsgeolocationlanguage
Example:geolocation
querystring

Search query

Example:New York
locationIdstringrequired

Location identifier

Example:loc_abc123

Response

application/json

Geo targets when type=geolocation, or language constants when type=language

oneOf
  • Array items
    • resourceNamestringrequired

    Google Ads resource name

    Example:geoTargetConstants/9040245
    idstringrequired

    Geo target constant id

    Example:9040245
    statusstringrequired

    Target status

    Example:ENABLED
    namestringrequired

    Location name

    Example:Thane
    countryCodestringrequired

    Two-letter ISO country code

    Example:IN
    targetTypestringrequired

    Granularity of the target, e.g. Country, State, City, District, Postal Code

    Example:City
    canonicalNamestringrequired

    Fully qualified name, comma separated from most to least specific

    Example:Thane,Thane,Maharashtra,India
    reachstringrequired

    Approximate addressable population, returned as a string rather than a number

    Example:3000000