Method: customers.generateKeywordHistoricalMetrics

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/v15/customers/{customerId}:generateKeywordHistoricalMetrics

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 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Campi
keywords[]

string

Un elenco di parole chiave per ottenere le metriche storiche. Non tutti gli input verranno restituiti come risultato della deduplicazione quasi esatta. Ad esempio, se vengono richieste statistiche per "auto" e "automobili", verrà restituito solo "auto". Puoi utilizzare un massimo di 10.000 parole chiave.
includeAdultKeywords

boolean

Se è vero, le parole chiave per adulti verranno incluse nella risposta. Il valore predefinito è false.
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.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Rete di targeting. Se non viene configurato, verrà utilizzata la rete di ricerca e partner di Google.
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.

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 (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Campi
results[]

object (GenerateKeywordHistoricalMetricsResult)

Elenco delle parole chiave e delle relative metriche storiche.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

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 Panoramica di OAuth 2.0.

GenerateKeywordHistoricalMetricsResult

Il risultato della generazione di metriche storiche delle parole chiave.

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

string

L'elenco di varianti simili delle parole chiave richieste le cui statistiche sono combinate in questo CreateKeywordStoricoMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Le metriche storiche per il testo e le sue varianti simili
text

string

Il testo della query associato a una o più parole chiave. Tieni presente che eseguiamo la deduplicazione dell'elenco di parole chiave, eliminando le varianti simili prima di restituire le parole chiave come testo. Ad esempio, se originariamente la tua richiesta conteneva le parole chiave "auto" e "automobili", la query di ricerca restituita conterrà solo "automobili". L'elenco delle query deduplicate verrà incluso nel campo chiudiVariants.