Method: customers.generateKeywordHistoricalMetrics

Restituisce un elenco di metriche storiche per le parole chiave.

Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID del cliente con il consiglio.

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 a seguito della deduplica quasi esatta. Ad esempio, se vengono richieste le statistiche per "auto" e "automobili", verrà restituito solo "auto". È possibile utilizzare un massimo di 10.000 parole chiave.
includeAdultKeywords

boolean

Se true, 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 numero massimo è 10. È POSSIBILE utilizzare un elenco vuoto per specificare tutti i paesi di destinazione.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Rete di destinazione. Se non viene impostato, verrà utilizzata la rete Google Search e partner.
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 di parole chiave e 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 sezione OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Il risultato della generazione delle metriche storiche per le parole chiave.

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

string

L'elenco delle varianti simili delle parole chiave richieste le cui statistiche vengono combinate in questo GenerateKeywordHistoricalMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

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

string

Il testo della query associata a una o più parole chiave. Tieni presente che eliminiamo le parole chiave duplicate dall'elenco, 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 "automobili", la query di ricerca restituita conterrà solo "automobili". L'elenco delle query deduplicati verrà incluso nel campo closeVariants.