Method: geoTargetConstants.suggest

Retorna sugestões GeoTargetConstant por nome do local ou por nome do recurso.

Lista de erros gerados: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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.
}
Campos
locale

string

Se possível, as segmentações geográficas retornadas são traduzidas usando essa localidade. Caso contrário, en é usado por padrão. Isso também é usado como uma dica para segmentações geográficas retornadas.
countryCode

string

As segmentações geográficas retornadas estão restritas a este código de país.
Campo de união query. Obrigatório. Um seletor de constantes de segmentação geográfica. query pode ser apenas de um dos tipos a seguir:
locationNames

object (LocationNames)

Os nomes dos locais a serem pesquisados. É possível definir no máximo 25 nomes.
geoTargets

object (GeoTargets)

Os nomes de recursos constantes da segmentação geográfica para filtrar.

Corpo da resposta

Mensagem de resposta para GeoTargetConstantService.SuggestGeoTargetConstants.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Campos
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Sugestões constantes da segmentação geográfica.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

LocationNames

Uma lista de nomes de locais.

Representação JSON 
{
  "names": [
    string
  ]
}
Campos
names[]

string

Uma lista de nomes de locais.

GeoTargets

Uma lista de nomes de recursos constantes de segmentação geográfica.

Representação JSON 
{
  "geoTargetConstants": [
    string
  ]
}
Campos
geoTargetConstants[]

string

Uma lista de nomes de recursos constantes de segmentação geográfica.

GeoTargetConstantSuggestion

Uma sugestão constante de segmentação geográfica.

Representação JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Campos
geoTargetConstant

object (GeoTargetConstant)

O resultado GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

A lista de pais da constante de segmentação geográfica.
locale

string

O idioma para o qual GeoTargetConstantSuggestion está traduzido no momento. Ela afeta o nome dos campos de segmentação geográfica. Por exemplo, se locale=pt-BR, nome=Espanha. Se locale=es, então name=España. A localidade padrão será retornada se não houver tradução para a localidade na solicitação.
reach

string (int64 format)

É a população aproximada de usuários que vai ser segmentada, arredondada para a centena mais próxima.
searchTerm

string

Se a solicitação pesquisada pelo nome do local, esse será o nome do local correspondente à segmentação geográfica.