Method: customers.generateKeywordHistoricalMetrics

Zwraca listę danych historycznych słów kluczowych.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta z rekomendacją.

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, z których możesz uzyskać dane historyczne. W wyniku deduplikacji prawie dokładnej nie wszystkie dane wejściowe zostaną zwrócone. Jeśli na przykład żądane są statystyki dla słów „samochód” i „samochody”, zwrócone zostanie tylko słowo „samochód”. Można użyć maksymalnie 10 000 słów kluczowych.
includeAdultKeywords

boolean

Jeśli ma wartość true (prawda), odpowiedź będzie zawierać słowa kluczowe związane z treściami dla dorosłych. Wartość domyślna to false (fałsz).
geoTargetConstants[]

string

Nazwy zasobów lokalizacji, na którą chcesz kierować reklamy. Maksymalna wartość to 10. MOGĄ używać pustej listy do określenia wszystkich docelowych lokalizacji geograficznych.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Kierowanie na sieć. Jeśli zasada nie jest skonfigurowana, używana jest sieć wyszukiwania i partnerów Google.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Pola zbiorcze, które mają zostać uwzględnione w odpowiedzi.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opcje danych historycznych.
language

string

Nazwa zasobu języka, na który chcesz kierować reklamy. Każde słowo kluczowe należy do pewnego zestawu języków. Słowo kluczowe jest uwzględniane, jeśli język jest jednym z jego języków. Jeśli zasada nie jest skonfigurowana, uwzględniane będą wszystkie słowa kluczowe.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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)

Zbiorcze dane 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 artykule Omówienie protokołu OAuth 2.0.

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ą połączone w wyniku GenerateKeywordHistoryMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

dane historyczne dotyczące tekstu i jego bliskich odmian,
text

string

Tekst zapytania powiązany z co najmniej jednym słowem kluczowym. Pamiętaj, że usuwamy duplikaty z listy słów kluczowych, eliminując zbliżone odmiany przed zwróceniem słów kluczowych w postaci tekstu. Jeśli np. w zapytaniu pierwotnie zawarte były słowa kluczowe „samochód” i „samochody”, zwrócone zapytanie będzie zawierać tylko słowo „samochody”. Lista zapytań, które zostały po usunięciu duplikatów, pojawi się w polu closeVariants.