Method: geoTargetConstants.suggest

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

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

Solicitud HTTP

POST https://googleads.googleapis.com/v14/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 traducen con esta configuración regional. De lo contrario, se usará en de forma predeterminada. También se usa como sugerencia para las orientaciones geográficas mostradas.

countryCode

string

Las segmentaciones geográficas mostradas 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 en las que se buscará. Se pueden establecer 25 nombres como máximo.

geoTargets

object (GeoTargets)

Los nombres de los recursos constantes de las segmentaciones geográficas por los que se debe 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 objetivos geográficos.

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

string

Una lista de nombres de recursos constantes de objetivos geográficos.

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 la segmentación geográfica. Por ejemplo, si regional=en, entonces name=España. Si regional=es, name=España. Se mostrará la configuración regional predeterminada si no existe ninguna traducción para la configuración regional en la solicitud.

reach

string (int64 format)

Población de usuarios aproximada a la que se segmentará, 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.