- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Prova!
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/v15/customers/{customerId}:generateKeywordIdeas
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
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 ( |
Campi | |
---|---|
geoTargetConstants[] |
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 |
Se è vero, le parole chiave per adulti verranno incluse nella risposta. Il valore predefinito è false. |
pageToken |
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 |
pageSize |
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 |
Rete di targeting. Se non viene configurato, verrà utilizzata la rete di ricerca e partner di Google. |
keywordAnnotation[] |
Le annotazioni delle parole chiave da includere nella risposta. |
aggregateMetrics |
I campi aggregati da includere nella risposta. |
historicalMetricsOptions |
Le opzioni per i dati delle metriche storiche. |
language |
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 |
Una parola chiave e un URL specifico da cui generare idee, ad esempio auto, www.example.com/auto. |
keywordSeed |
Una parola chiave o una frase da cui generare idee, ad esempio, automobili. |
urlSeed |
Un URL specifico da cui generare idee, ad esempio www.example.com/auto. |
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 ( |
Campi | |
---|---|
results[] |
Risultati della generazione di idee per le parole chiave. |
aggregateMetricResults |
Le metriche aggregate per tutte le idee per le parole chiave. |
nextPageToken |
Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Passa i contenuti di questa stringa come attributo |
totalSize |
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[] |
Richiede almeno una parola chiave. |
url |
L'URL di cui eseguire la scansione per generare idee per le parole chiave. |
KeywordSeed
Parola chiave originale
Rappresentazione JSON |
---|
{ "keywords": [ string ] } |
Campi | |
---|---|
keywords[] |
Richiede almeno una parola chiave. |
UrlSeed
Seed URL
Rappresentazione JSON |
---|
{ "url": string } |
Campi | |
---|---|
url |
L'URL di cui eseguire la scansione per generare idee per le parole chiave. |
SiteSeed
Seed del sito
Rappresentazione JSON |
---|
{ "site": string } |
Campi | |
---|---|
site |
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 ( |
Campi | |
---|---|
keywordIdeaMetrics |
Le metriche storiche della parola chiave. |
keywordAnnotations |
Le annotazioni per la parola chiave. I dati dell'annotazione vengono forniti solo se richiesti. |
closeVariants[] |
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 |
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 ( |
Campi | |
---|---|
concepts[] |
L'elenco dei concetti per la parola chiave. |
KeywordConcept
Il concetto per la parola chiave.
Rappresentazione JSON |
---|
{
"name": string,
"conceptGroup": {
object ( |
Campi | |
---|---|
name |
Il nome del concetto per la parola chiave nel conceptGroup. |
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 ( |
Campi | |
---|---|
name |
Il nome del gruppo di concetti. |
type |
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. |