type Location (v202411)

  • The Location entity represents a targetable geographical area like a country, city, or state.

  • Location is sub-classed based on API version, defaulting to the base class if unavailable.

  • Each Location is uniquely identified by an ID and categorized by type and name.

  • Locations can have a parent, indicated by a canonical parent ID for hierarchical structure.

  • Location data includes its unique ID, type, parent's ID (if applicable), and localized display name.

A Location represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly.


Namespace
https://www.google.com/apis/ads/publisher/v202411

Field

id

xsd:long

Uniquely identifies each Location.

type

xsd:string

The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.)

canonicalParentId

xsd:int

The nearest location parent's ID for this geographical entity.

displayName

xsd:string

The localized name of the geographical entity.