Method: customers.generateKeywordHistoricalMetrics

Anahtar kelime geçmiş metriklerinin listesini döndürür.

Atılan hataların listesi: AuthenticationError YetkilendirmeHatası CollectionSizeError HeaderError InternalError KotalarError RequestError

HTTP isteği

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

URL, gRPC Kod dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Öneriyi içeren müşterinin kimliği.

İstek metni

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

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

string

Geçmiş metrikleri almak için bir anahtar kelime listesi. Tam olarak tekilleştirme işleminin bir sonucu olarak tüm girişler döndürülmez. Örneğin, "arabalar" ve "arabalar" için istatistikler istenirse yalnızca "araba" sonucu döndürülür. En fazla 10.000 anahtar kelime kullanılabilir.
includeAdultKeywords

boolean

Bu özellik doğru değerine ayarlanırsa yetişkinlere uygun anahtar kelimeler yanıt olarak eklenir. Varsayılan değer false (yanlış) değeridir.
geoTargetConstants[]

string

Hedeflenecek konumun kaynak adları. Maksimum 10 olabilir. Boş bir liste, tüm hedefleme coğrafi konumlarını belirtmek için KULLANILABİLİR.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Ağ hedefleniyor. Politika ayarlanmazsa Google googleAds.search And Partners Ağı kullanılır.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Yanıtta dahil edilecek toplam alan.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verileri için seçenekler.
language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime bazı dil gruplarına aittir; dil, dillerden biriyse dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.

Yanıt metni

Başarılı olursa yanıt gövdesi aşağıdaki yapıyla birlikte verileri içerir:

KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics için yanıt mesajı.

JSON gösterimi 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Alanlar
results[]

object (GenerateKeywordHistoricalMetricsResult)

Anahtar kelimelerin listesi ve bu metriklerin geçmiş metrikleri.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Tüm anahtar kelimeler için toplu metrikler.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

CreateKeywordHistoryMetricsResult

Anahtar kelime geçmiş metrikleri oluşturma sonucu.

JSON gösterimi 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Alanlar
closeVariants[]

string

İstenen anahtar kelimelerin istatistikleri bu GenerateKeywordHistoryMetricsResult'da birleştirilen yakın varyasyonları listesi.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Metin ve yakın varyasyonları için geçmiş metrikler
text

string

Bir veya daha fazla anahtar kelimeyle ilişkili sorgunun metni. Anahtar kelimeler listenizi tekilleştirmeden, yakın varyasyonları ortadan kaldırarak anahtar kelime listenizi tekilleştirdiğimizi unutmayın. Örneğin, isteğiniz başlangıçta "arabalar" ve "arabalar" anahtar kelimelerini içeriyorsa döndürülen arama sorgusu yalnızca "arabalar"ı içerir. Tekilleştirilmiş sorgular listesi, CloseVarys alanına eklenir.