Returns the list of plannable locations (for example, countries & DMAs).
List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP request
POST https://googleads.googleapis.com/v9:listPlannableLocations
The URL uses gRPC Transcoding syntax.
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
The list of plannable locations.
JSON representation | |
---|---|
{
"plannableLocations": [
{
object ( |
Fields | |
---|---|
plannableLocations[] |
The list of locations available for planning (Countries, DMAs, sub-countries). For locations like Countries and DMAs see https://developers.google.com/google-ads/api/reference/data/geotargets for more information. |
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adwords
For more information, see the OAuth 2.0 Overview.
PlannableLocation
A plannable location: a country, a DMA, a metro region, a tv region, a province.
JSON representation | |
---|---|
{ "id": string, "name": string, "parentCountryId": string, "countryCode": string, "locationType": string } |
Fields | |
---|---|
id |
The location identifier. |
name |
The unique location name in english. |
parentCountryId |
The parent country, not present if location is a country. If present will always be a GeoTargetConstant ID. Additional information, such as country name is provided by |
countryCode |
The ISO-3166-1 alpha-2 country code that is associated with the location. |
locationType |
The location's type. Location types correspond to targetType returned by |