Returns the list of plannable locations (for example, countries).
List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP request
POST https://googleads.googleapis.com/v20:listPlannableLocations
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"reachApplicationInfo": {
object ( |
Fields | |
---|---|
reachApplicationInfo |
Optional. Additional information on the application issuing the request. |
Response body
The list of plannable locations.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"plannableLocations": [
{
object ( |
Fields | |
---|---|
plannableLocations[] |
The list of locations available for planning. See https://developers.google.com/google-ads/api/reference/data/geotargets for sample locations. |
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: country, metro region, province, etc.
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 searching location type in GoogleAdsService.Search/SearchStream. |