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/v16/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żna uzyskać dane historyczne. W wyniku usunięcia duplikatów nie wszystkie dane wejściowe zostaną zwrócone. Jeśli np. żądane są statystyki dla kategorii „samochód” i „samochody”, zwracany jest tylko wyraz „samochód”. Można użyć maksymalnie 10 000 słów kluczowych.
includeAdultKeywords

boolean

Jeśli ma wartość true (prawda), odpowiedź zawiera słowa kluczowe związane z tylko 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. MOŻNA użyć pustej listy do określenia wszystkich docelowych lokalizacji geograficznych.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Kierowanie na sieć. Jeśli zasada nie jest skonfigurowana, używana będzie sieć wyszukiwania i sieć 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 są kierowane 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 języków. Jeśli jej nie skonfigurujesz, uwzględnione będą 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)

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 omówieniu 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 zostały połączone w ramach tego parametru GenerateKeywordHistoryMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

dane historyczne o tekście i jego bliskich odmianach,
text

string

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