Method: geoTargetConstants.suggest

Restituisce suggerimenti GeoTargetConstant per nome della località o della risorsa.

Elenco degli errori generati: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
locale

string

Se possibile, i target geografici restituiti vengono tradotti utilizzando queste impostazioni internazionali. In caso contrario, per impostazione predefinita viene utilizzato il valore en. Viene utilizzato anche come suggerimento per i target geografici restituiti.
countryCode

string

I target geografici restituiti sono limitati a questo codice paese.
Campo di unione query. Obbligatorio. Un selettore di costanti di targeting geografico. query può essere solo uno dei seguenti:
locationNames

object (LocationNames)

I nomi delle località in base a cui eseguire la ricerca. È possibile impostare al massimo 25 nomi.
geoTargets

object (GeoTargets)

I nomi delle risorse costanti di targeting geografico in base ai quali filtrare.

Corpo della risposta

Messaggio di risposta per GeoTargetConstantService.SuggestGeoTargetConstants.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Campi
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Suggerimenti costanti per il targeting geografico.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

LocationNames

Un elenco di nomi di posizioni.

Rappresentazione JSON 
{
  "names": [
    string
  ]
}
Campi
names[]

string

Un elenco di nomi di posizioni.

GeoTargets

Un elenco di nomi di risorse costanti con targeting geografico.

Rappresentazione JSON 
{
  "geoTargetConstants": [
    string
  ]
}
Campi
geoTargetConstants[]

string

Un elenco di nomi di risorse costanti con targeting geografico.

GeoTargetConstantSuggestion

Suggerimento di una costante di targeting geografico.

Rappresentazione JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Campi
geoTargetConstant

object (GeoTargetConstant)

Il risultato GeoTargetCost.
geoTargetConstantParents[]

object (GeoTargetConstant)

L'elenco degli elementi principali della costante di targeting geografico.
locale

string

La lingua in cui è attualmente tradotto questo GeoTargetCostSuggestion. Influisce sul nome dei campi di targeting geografico. Ad esempio, se locale=en, allora name=Spagna. Se locale=es, name=España. Verranno restituite le impostazioni internazionali predefinite se non esiste alcuna traduzione per le impostazioni internazionali nella richiesta.
reach

string (int64 format)

Numero approssimativo di utenti scelti come target, arrotondata al centinaio più prossimo.
searchTerm

string

Se la richiesta cerca in base al nome della località, si tratta del nome della località corrispondente al target geografico.