Method: listPlannableLocations

Возвращает список планируемых местоположений (например, стран).

Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v15:listPlannableLocations

URL-адрес использует синтаксис транскодирования gRPC .

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Список планируемых локаций.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
Поля
plannableLocations[]

object ( PlannableLocation )

Список локаций, доступных для планирования. См. https://developers.google.com/google-ads/api/reference/data/geotargets для примеров местоположений.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

ПланируемоеМестоположение

Планируемое местоположение: страна, агломерация, провинция и т. д.

JSON-представление
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
Поля
id

string

Идентификатор местоположения.

name

string

Уникальное название локации на английском языке.

parentCountryId

string ( int64 format)

Родительская страна (отсутствует, если местоположение является страной). Если он присутствует, всегда будет идентификатором GeoTargetConstant. Дополнительная информация, такая как название страны, предоставляется ReachPlanService.ListPlannableLocations или GoogleAdsService.Search/SearchStream.

countryCode

string

Код страны ISO-3166-1 альфа-2, связанный с местоположением.

locationType

string

Тип местоположения. Типы местоположений соответствуют targetType, возвращаемому типом местоположения поиска в GoogleAdsService.Search/SearchStream.