Method: customers.generateKeywordIdeas

Restituisce un elenco di idee per le parole chiave.

Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordIdeas

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID del cliente con il suggerimento.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Campi
geoTargetConstants[]

string

I nomi delle risorse della località target. Il valore massimo è 10. È POSSIBILE utilizzare un elenco vuoto per specificare tutti i dati geografici di targeting.
includeAdultKeywords

boolean

Se vero, le parole chiave per adulti saranno incluse nella risposta. Il valore predefinito è false.
pageToken

string

Token della pagina da recuperare. Se non specificato, verrà restituita la prima pagina di risultati. Per richiedere la pagina di risultati successiva, utilizza il valore ottenuto da nextPageToken nella risposta precedente. I campi di richiesta devono corrispondere in tutte le pagine.
pageSize

integer

Numero di risultati da recuperare in una singola pagina. È possibile restituire un massimo di 10.000 risultati. Se il valore di pageSize supera questo valore, verrà ignorato. Se non specificati, verranno restituiti al massimo 10.000 risultati. Il server può decidere di limitare ulteriormente il numero di risorse restituite. Se la risposta contiene meno di 10.000 risultati,potrebbe non essere considerata come l'ultima pagina dei risultati.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Rete di targeting. Se non viene configurato, verrà utilizzata la rete di ricerca e partner di Google.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Le annotazioni delle parole chiave da includere nella risposta.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

I campi aggregati da includere nella risposta.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Le opzioni per i dati delle metriche storiche.
language

string

Il nome della risorsa della lingua di destinazione. Ogni parola chiave appartiene a un insieme di lingue; una parola chiave è inclusa se la lingua è una delle sue lingue. Se non viene configurato, vengono incluse tutte le parole chiave.
Campo di unione seed. Il tipo di origine con cui generare idee per le parole chiave. seed può essere solo uno dei seguenti:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Una parola chiave e un URL specifico da cui generare idee, ad esempio auto, www.example.com/auto.
keywordSeed

object (KeywordSeed)

Una parola chiave o una frase da cui generare idee, ad esempio, dalle auto.
urlSeed

object (UrlSeed)

Un URL specifico da cui generare idee, ad esempio www.example.com/auto.
siteSeed

object (SiteSeed)

Il sito da cui generare idee, ad esempio www.example.com.

Corpo della risposta

Messaggio di risposta per KeywordPlanIdeaService.GenerateKeywordIdeas.

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

Rappresentazione JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Campi
results[]

object (GenerateKeywordIdeaResult)

Risultati della generazione di idee per le parole chiave.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Le metriche aggregate per tutte le idee per le parole chiave.
nextPageToken

string

Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa i contenuti di questa stringa come attributo pageToken della richiesta successiva. nextPageToken non è stato restituito per l'ultima pagina.
totalSize

string (int64 format)

Numero totale di risultati disponibili.

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.

KeywordPlanKeywordAnnotation

Enumera le annotazioni del piano delle parole chiave che è possibile richiedere.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
KEYWORD_CONCEPT Restituisce i dati dei concetti della parola chiave e del gruppo dei concetti.

KeywordAndUrlSeed

Parola chiave e origine dell'URL

Rappresentazione JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
Campi
keywords[]

string

Richiede almeno una parola chiave.
url

string

L'URL di cui eseguire la scansione per generare idee per le parole chiave.

KeywordSeed

Parola chiave iniziale

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

string

Richiede almeno una parola chiave.

UrlSeed

Seed URL

Rappresentazione JSON 
{
  "url": string
}
Campi
url

string

L'URL di cui eseguire la scansione per generare idee per le parole chiave.

SiteSeed

Semina del sito

Rappresentazione JSON 
{
  "site": string
}
Campi
site

string

Il nome di dominio del sito. Se il cliente che richiede le idee non è il proprietario del sito, vengono restituite solo le informazioni pubbliche.

GenerateKeywordIdeaResult

Il risultato della generazione di idee per le parole chiave.

Rappresentazione JSON 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
Campi
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

Le metriche storiche della parola chiave.
keywordAnnotations

object (KeywordAnnotations)

Le annotazioni per la parola chiave. I dati dell'annotazione vengono forniti solo se richiesti.
closeVariants[]

string

L'elenco di varianti simili delle parole chiave richieste combinate in questo ritorno ideaperparolaechiave. Per la definizione di "varianti simili", consulta la pagina https://support.google.com/google-ads/answer/9342105.
text

string

Testo dell'idea per la parola chiave. Come nelle metriche storiche del piano per le parole chiave, questo testo potrebbe non essere una parola chiave effettiva, ma la forma canonica di più parole chiave. Vedi il messaggio KeywordPlanKeywordStoricoMetrics in KeywordPlanService.

KeywordAnnotations

Le annotazioni per le parole chiave del piano di parole chiave.

Rappresentazione JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Campi
concepts[]

object (KeywordConcept)

L'elenco dei concetti per la parola chiave.

KeywordConcept

Il concetto della parola chiave.

Rappresentazione JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Campi
name

string

Il nome del concetto per la parola chiave nel conceptGroup.
conceptGroup

object (ConceptGroup)

Il gruppo concettuale dei dettagli del concetto.

ConceptGroup

Il gruppo dei concetti del concetto di parola chiave.

Rappresentazione JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Campi
name

string

Il nome del gruppo di concetti.
type

enum (KeywordPlanConceptGroupType)

Il tipo di gruppo dei concetti.

KeywordPlanConceptGroupType

Enumera i tipi di gruppo del concetto di piano delle parole chiave.

Enum
UNSPECIFIED La classificazione del gruppo dei concetti è diversa da quella del brand/non del brand. Questo è un bucket catch all per tutte le classificazioni che non sono tra quelle riportate di seguito.
UNKNOWN Il valore è sconosciuto in questa versione.
BRAND La classificazione del gruppo di concetti si basa sul BRAND.
OTHER_BRANDS La classificazione del gruppo di concetti basata su BRAND, che non si adattava bene alle classificazioni di BRAND. Si tratta generalmente di valori anomali e possono essere associati a pochissime parole chiave in questo tipo di classificazione.
NON_BRAND Questa classificazione in gruppi di concetti non si basa sul BRAND. Questo valore viene restituito per le parole chiave generiche che non hanno un'associazione con il brand.