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/v14/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 valore massimo è 10. È POSSIBILE utilizzare un elenco vuoto per specificare tutte le aree geografiche di targeting.
includeAdultKeywords

boolean

Se è vero, 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 di richiesta devono corrispondere nelle 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, questo viene ignorato. Se il valore 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,potrebbe non essere considerata come 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 viene inclusa se la lingua è una delle sue lingue. Se non viene impostato, verranno incluse tutte le parole chiave.
Campo di unione seed. Il tipo di seed 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, automobili.
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 da 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 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 Restituire i dati del concetto di parola chiave e del gruppo di 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 originale

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

Seed 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 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 risultato per l'idea per le parole chiave. Consulta la pagina https://support.google.com/google-ads/answer/9342105 per la definizione di "varianti simili".
text

string

Testo dell'idea per la parola chiave. Come nelle metriche storiche del piano delle parole chiave, questo testo potrebbe non essere una parola chiave effettiva, ma essere 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 per la 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 di concetti dei dettagli del concetto.

ConceptGroup

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

KeywordPlanConceptGroupType

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

Enum
UNSPECIFIED La classificazione del gruppo concettuale è diversa da quella correlata al brand/non al brand. Si tratta di 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 concettuale 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 anomalie e possono avere pochissime parole chiave in questo tipo di classificazione.
NON_BRAND La classificazione di questi gruppi non si basa su BRAND. Questo viene restituito per le parole chiave generiche che non hanno un'associazione con il brand.