Method: geoTargetConstants.suggest

Muestra sugerencias GeoTargetConstant por nombre de ubicación o nombre de recurso.

Lista de errores arrojados: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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

Si es posible, las orientaciones geográficas mostradas se traducirán con esta configuración regional. De lo contrario, se utiliza "en" de forma predeterminada. Esto también se usa como sugerencia para las segmentaciones geográficas que se muestran.

countryCode

string

Las segmentaciones geográficas que se muestran están restringidas a este código de país.

Campo de unión query. Obligatorio. Un selector de constantes de segmentación geográfica. Las direcciones (query) solo pueden ser una de las siguientes opciones:
locationNames

object (LocationNames)

Los nombres de las ubicaciones que se buscarán. Se pueden establecer 25 nombres como máximo.

geoTargets

object (GeoTargets)

Son los nombres de recursos constantes de las segmentaciones geográficas que se usarán para filtrar.

Cuerpo de la respuesta

Mensaje de respuesta para GeoTargetConstantService.SuggestGeoTargetConstants.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Campos
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Sugerencias constantes de segmentación geográfica.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

LocationNames

Una lista de nombres de ubicaciones.

Representación JSON
{
  "names": [
    string
  ]
}
Campos
names[]

string

Una lista de nombres de ubicaciones.

GeoTargets

Una lista de nombres de recursos constantes de segmentaciones geográficas.

Representación JSON
{
  "geoTargetConstants": [
    string
  ]
}
Campos
geoTargetConstants[]

string

Una lista de nombres de recursos constantes de segmentaciones geográficas.

GeoTargetConstantSuggestion

Una sugerencia constante de segmentación geográfica

Representación JSON
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Campos
geoTargetConstant

object (GeoTargetConstant)

El resultado de GeoTargetConstant.

geoTargetConstantParents[]

object (GeoTargetConstant)

Es la lista de elementos superiores de la constante de segmentación geográfica.

locale

string

Es el idioma al que actualmente se traduce este GeoTargetConstantSuggestion. Afecta el nombre de los campos de segmentación geográfica. Por ejemplo, si regional=en, name=España. Si regional=es, name=España. Si no existe una traducción para esta configuración regional en la solicitud, se mostrará la configuración regional predeterminada.

reach

string (int64 format)

Población de usuarios aproximada a la que se orientará, redondeada a la centena más cercana.

searchTerm

string

Si la solicitud se buscó por nombre de ubicación, este es el nombre de la ubicación que coincidió con la segmentación geográfica.