Method: geoTargetConstants.suggest

Возвращает предложения GeoTargetConstant по имени местоположения или имени ресурса.

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

HTTP-запрос

POST https://googleads.googleapis.com/v14/geoTargetConstants:suggest

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

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
Поля
locale

string

Если возможно, возвращаемые географические цели переводятся с использованием этого языкового стандарта. В противном случае по умолчанию используется en. Это также используется как подсказка для возвращаемых географических целей.

countryCode

string

Возвращаемые географические цели ограничены этим кодом страны.

query поля объединения. Необходимый. Селектор констант геотаргета. query может быть только одним из следующих:
locationNames

object ( LocationNames )

Названия местоположений для поиска. Можно задать не более 25 имен.

geoTargets

object ( GeoTargets )

Имена постоянных ресурсов географической цели для фильтрации.

Тело ответа

Ответное сообщение для GeoTargetConstantService.SuggestGeoTargetConstants .

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

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

object ( GeoTargetConstantSuggestion )

Постоянные предложения по геотаргетингу.

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

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

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

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

Названия местоположений

Список названий локаций.

JSON-представление
{
  "names": [
    string
  ]
}
Поля
names[]

string

Список названий локаций.

Геоцели

Список имен постоянных ресурсов географических целей.

JSON-представление
{
  "geoTargetConstants": [
    string
  ]
}
Поля
geoTargetConstants[]

string

Список имен постоянных ресурсов географических целей.

GeoTargetConstantПредложение

Постоянное предложение по геотаргетингу.

JSON-представление
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Поля
geoTargetConstant

object ( GeoTargetConstant )

Результат GeoTargetConstant.

geoTargetConstantParents[]

object ( GeoTargetConstant )

Список родительских констант географической цели.

locale

string

Язык, на который в настоящее время переведено это GeoTargetConstantSuggestion. Это влияет на название полей геотаргетинга. Например, если locale=en, то name=Spain. Если локаль=es, то name=España. Языковой стандарт по умолчанию будет возвращен, если для языкового стандарта в запросе не существует перевода.

reach

string ( int64 format)

Приблизительное количество целевых пользователей, округленное до ближайших 100.

searchTerm

string

Если запрос выполняется по названию местоположения, это имя местоположения, соответствующее географической цели.