Method: customers.generateKeywordHistoricalMetrics

Zwraca listę danych historycznych słów kluczowych.

Lista błędów: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta, dla którego jest przeznaczona rekomendacja.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Pola
keywords[]

string

lista słów kluczowych, dla których chcesz uzyskać dane historyczne; Nie wszystkie dane wejściowe zostaną zwrócone w ramach prawie dokładnego usuwania duplikatów. Jeśli na przykład zażądasz statystyk dotyczących słów „samochód” i „samochody”, zostanie zwrócona tylko wartość „samochód”. Możesz użyć maksymalnie 10 tys. słów kluczowych.
includeAdultKeywords

boolean

Jeśli wartość to Prawda, w odpowiedzi będą uwzględniane słowa kluczowe dla dorosłych. Wartość domyślna to false (fałsz).
geoTargetConstants[]

string

Nazwy zasobów lokalizacji docelowej. Maksymalna liczba to 10. Pustą listę można użyć do określenia wszystkich kierowań geograficznych.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Sieć kierowania. Jeśli nie zostanie ustawiona, używana będzie sieć wyszukiwarki Google i partnerów.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Pola agregacji do uwzględnienia w odpowiedzi.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opcje danych historycznych dotyczących danych statystycznych.
language

string

Nazwa zasobu języka docelowego. Każde słowo kluczowe należy do pewnego zbioru języków; słowo kluczowe jest uwzględniane, jeśli język jest jednym z tych języków. Jeśli nie ustawisz tego parametru, zostaną uwzględnione wszystkie słowa kluczowe.

Treść odpowiedzi

Odpowiedź na pytanie „KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics”.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Pola
results[]

object (GenerateKeywordHistoricalMetricsResult)

Lista słów kluczowych i ich danych historycznych.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Dane zbiorcze dotyczące wszystkich słów kluczowych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Wynik generowania danych historycznych słów kluczowych.

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

string

Lista zbliżonych odmian żądanych słów kluczowych, których statystyki są łączone w tym wywołaniu funkcji GenerateKeywordHistoricalMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Dane historyczne dotyczące tekstu i jego podobnych wariantów
text

string

Tekst zapytania powiązanego z co najmniej 1 słowem kluczowym. Pamiętaj, że przed zwróceniem słów kluczowych jako tekstu usuwamy z listy duplikaty i zbliżone odmiany. Jeśli na przykład Twoje żądanie pierwotnie zawierało słowa kluczowe „samochód” i „samochody”, zwrócone zapytanie będzie zawierać tylko „samochody”. Lista zapytań po usunięciu duplikatów zostanie uwzględniona w polu closeVariants.