Method: geoTargetConstants.suggest

Renvoie des suggestions GeoTargetConstant par nom d'emplacement ou par nom de ressource.

Liste des erreurs générées: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
locale

string

Si possible, les cibles géographiques renvoyées sont traduites en fonction de ces paramètres régionaux. Dans le cas contraire, l'anglais est utilisé par défaut. Il sert également d'indication pour les cibles géographiques renvoyées.
countryCode

string

Les cibles géographiques renvoyées sont limitées à ce code pays.
Champ d'union query. Obligatoire. Un sélecteur de constantes de cible géographique. query ne peut être qu'un des éléments suivants :
locationNames

object (LocationNames)

Noms des lieux à utiliser pour la recherche. Vous pouvez définir jusqu'à 25 noms.
geoTargets

object (GeoTargets)

Noms de ressources des constantes de la cible géographique à utiliser comme filtre.

Corps de la réponse

Message de réponse pour GeoTargetConstantService.SuggestGeoTargetConstants.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Champs
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Suggestions de constantes pour les cibles géographiques

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

LocationNames

Liste de noms d'établissements.

Représentation JSON 
{
  "names": [
    string
  ]
}
Champs
names[]

string

Liste de noms d'établissements.

GeoTargets

Liste des noms de ressources de la cible géographique

Représentation JSON 
{
  "geoTargetConstants": [
    string
  ]
}
Champs
geoTargetConstants[]

string

Liste des noms de ressources de la cible géographique

GeoTargetConstantSuggestion

Suggestion de constante de cible géographique.

Représentation JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Champs
geoTargetConstant

object (GeoTargetConstant)

Résultat GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

Liste des parents de la constante de la cible géographique.
locale

string

Langue dans laquelle cette GeoTargetConstantSuggestion est actuellement traduite. Cela a une incidence sur le nom des champs de cible géographique. Par exemple, si locale=en, nom=Espagne. Si locale=es, alors name=España. Les paramètres régionaux par défaut sont renvoyés si aucune traduction n'existe pour les paramètres régionaux de la requête.
reach

string (int64 format)

Population approximative d'utilisateurs qui sera ciblée, arrondie à la centaine la plus proche.
searchTerm

string

Si la requête a fait l'objet d'une recherche par nom de zone géographique, il s'agit du nom de zone géographique correspondant à la cible géographique.