- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- GenerateKeywordHistoricalMetricsResult
- Prova!
Restituisce un elenco di metriche storiche delle parole chiave.
Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordHistoricalMetrics
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 |
---|
{ "keywords": [ string ], "includeAdultKeywords": boolean, "geoTargetConstants": [ string ], "keywordPlanNetwork": enum ( |
Campi | |
---|---|
keywords[] |
Un elenco di parole chiave per visualizzare le metriche storiche. Non verranno restituiti tutti gli input come risultato della deduplicazione quasi esatta. Ad esempio, se vengono richieste le statistiche per "auto" e "auto", verrà restituito solo "auto". Puoi utilizzare un massimo di 10.000 parole chiave. |
includeAdultKeywords |
Se vero, le parole chiave per adulti saranno incluse nella risposta. Il valore predefinito è false. |
geoTargetConstants[] |
I nomi delle risorse della località target. Il valore massimo è 10. È POSSIBILE utilizzare un elenco vuoto per specificare tutti i dati geografici di targeting. |
keywordPlanNetwork |
Rete di targeting. Se non viene configurato, verrà utilizzata la rete di ricerca e partner di Google. |
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 è inclusa se la lingua è una delle sue lingue. Se non viene configurato, vengono incluse tutte le parole chiave. |
Corpo della risposta
Messaggio di risposta per KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "results": [ { object ( |
Campi | |
---|---|
results[] |
Elenco di parole chiave e relative metriche storiche. |
aggregateMetricResults |
Le metriche aggregate per tutte le parole chiave. |
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.
GenerateKeywordHistoricalMetricsResult
Il risultato della generazione di metriche storiche per le parole chiave.
Rappresentazione JSON |
---|
{
"closeVariants": [
string
],
"keywordMetrics": {
object ( |
Campi | |
---|---|
closeVariants[] |
L'elenco di varianti simili delle parole chiave richieste le cui statistiche sono combinate in questo CreateKeywordStoricoMetricsResult. |
keywordMetrics |
Le metriche storiche per il testo e le sue varianti simili |
text |
Il testo della query associato a una o più parole chiave. Tieni presente che eliminiamo i duplicati dell'elenco di parole chiave, eliminando le varianti simili prima di restituire le parole chiave come testo. Ad esempio, se la tua richiesta conteneva originariamente le parole chiave "auto" e "auto", la query di ricerca restituita conterrà solo "auto". L'elenco delle query deduplicate verrà incluso nel campo chiudiVariants. |