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/v16/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, la langue en est utilisée par défaut. Il sert également d'indice 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. Sélecteur de constantes de cibles géographiques. 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 des constantes de ciblage géographique à utiliser comme critères de filtrage.

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 de 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 de lieux.

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

string

Liste de noms de lieux.

GeoTargets

Liste de noms de ressources constantes de cibles géographiques.

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

string

Liste de noms de ressources constantes de cibles géographiques.

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. Elle affecte le nom des champs de cible géographique. Par exemple, si locale=en, name=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 ces paramètres régionaux dans la requête.
reach

string (int64 format)

Nombre approximatif d'utilisateurs qui seront ciblés, arrondi à 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 la zone correspondant à la cible géographique.