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/v18/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à da scegliere come target. Il numero massimo è 10. È POSSIBILE utilizzare un elenco vuoto per specificare tutti i paesi di destinazione.
includeAdultKeywords

boolean

Se true, le parole chiave per adulti verranno 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 successiva dei risultati, utilizza il valore ottenuto da nextPageToken nella risposta precedente. I campi della richiesta devono corrispondere tra le pagine.
pageSize

integer

Numero di risultati da recuperare in una singola pagina. È possibile restituire un massimo di 10.000 risultati. Se pageSize supera questo valore, viene ignorato. Se non specificato, verranno restituiti al massimo 10.000 risultati. Il server potrebbe decidere di limitare ulteriormente il numero di risorse restituite. Se la risposta contiene meno di 10.000 risultati, non può essere considerata l'ultima pagina di 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 da scegliere come target. Ogni parola chiave appartiene a un insieme di lingue; una parola chiave viene inclusa se la lingua è una delle sue lingue. Se non viene configurato, saranno incluse tutte le parole chiave.
Campo unione seed. Il tipo di origine per 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 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 parole chiave.
nextPageToken

string

Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa il contenuto di questa stringa come attributo pageToken della richiesta successiva. nextPageToken non viene 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 Panoramica di OAuth 2.0.

KeywordPlanKeywordAnnotation

Elenca le annotazioni del piano di parole chiave che possono essere richieste.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
KEYWORD_CONCEPT Restituisce i dati del concetto e del gruppo di concetti delle parole chiave.

KeywordAndUrlSeed

Seed parola chiave e URL

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

string

Richiede almeno una parola chiave.
url

string

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

KeywordSeed

Seed parola chiave

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

string

Richiede almeno una parola chiave.

UrlSeed

Origine URL

Rappresentazione JSON 
{
  "url": string
}
Campi
url

string

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

SiteSeed

Seed sito

Rappresentazione JSON 
{
  "site": string
}
Campi
site

string

Il nome di dominio del sito. Se il cliente che richiede le idee non è proprietario del sito, vengono restituite solo 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 della parola chiave. I dati delle annotazioni vengono forniti solo se richiesti.
closeVariants[]

string

L'elenco di varianti simili delle parole chiave richieste combinate in questo CreateKeywordIdeaResult. Per una 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 di parole chiave, questo testo potrebbe non essere una parola chiave effettiva, ma la forma canonica di più parole chiave. Visualizza il messaggio KeywordPlanKeywordHistoricalMetrics in KeywordPlanService.

KeywordAnnotations

Le annotazioni per le parole chiave relative al piano delle parole chiave.

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

object (KeywordConcept)

L'elenco di 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 gruppo di concetti.
conceptGroup

object (ConceptGroup)

Il gruppo di concetti dei dettagli del concetto.

ConceptGroup

Il gruppo di concetti per il concetto della 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 concettuale.

KeywordPlanConceptGroupType

Enumera i tipi di gruppi di concetti del piano di parole chiave.

Enum
UNSPECIFIED La classificazione del gruppo concettuale diversa da quella correlata al brand/non correlata al brand. Questo è un bucket catch all per tutte le classificazioni che non rientrano in nessuna delle seguenti.
UNKNOWN Il valore è sconosciuto in questa versione.
BRAND La classificazione del gruppo di concetti si basa su BRAND.
OTHER_BRANDS La classificazione del gruppo di concetti basata su BRAND, che non si adattava bene alle classificazioni BRAND. In genere si tratta di valori anomali e possono avere pochissime parole chiave in questo tipo di classificazione.
NON_BRAND La classificazione di questo gruppo di concetti non si basa su BRAND. Viene restituito per le parole chiave generiche che non hanno un'associazione con un brand.