Method: geoTargetConstants.suggest

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

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

Richiesta HTTP

POST https://googleads.googleapis.com/v16/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 numero 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 del target geografico in base ai quali applicare il filtro.

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 pagina 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 del target geografico.

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

string

Un elenco di nomi di risorse costanti del target geografico.

GeoTargetConstantSuggestion

Un suggerimento per la costante di targeting geografico.

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

object (GeoTargetConstant)

Il risultato GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

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

string

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

string (int64 format)

Popolazione di utenti approssimativa che verrà scelta come target, arrotondata al centinaio più prossimo.
searchTerm

string

Se la richiesta esegue una ricerca per nome della località, si tratta del nome della località corrispondente al target geografico.