Method: customers.generateKeywordHistoricalMetrics

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

Atılan hataların listesi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Öneri alan müşterinin kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte 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 alacağınız anahtar kelimelerin listesi. Tam olarak eşleşmeyen veriler, tam eşleşmeyen tekilleştirme işlemi sonucunda döndürülmeyebilir. Örneğin, "araba" ve "arabalar" için istatistikler istenirse yalnızca "araba" döndürülür. En fazla 10.000 anahtar kelime kullanılabilir.
includeAdultKeywords

boolean

Doğru ise yetişkinlere yönelik anahtar kelimeler yanıta dahil edilir. Varsayılan değer false (yanlış) değerini alır.
geoTargetConstants[]

string

Hedeflenecek konumun kaynak adları. Maksimum 10'dur. Tüm hedefleme coğrafi bölgelerini belirtmek için boş bir liste KULLANILABİLİR.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Hedefleme ağı. Ayarlanmazsa Google Arama ve İş Ortağı Ağı kullanılır.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Yanıta dahil edilecek toplu alanlar.
historicalMetricsOptions

object (HistoricalMetricsOptions)

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

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime belirli bir dil grubuna aittir. Dil, anahtar kelimenin dillerinden biriyse anahtar kelime dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.

Yanıt gövdesi

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

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

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

object (GenerateKeywordHistoricalMetricsResult)

Anahtar kelimelerin ve geçmiş metriklerinin listesi.
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 Overview sayfasına bakın.

GenerateKeywordHistoricalMetricsResult

Anahtar kelime geçmiş metriklerinin oluşturulması sonucunda elde edilen sonuç.

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

string

İstenen anahtar kelimelerdeki istatistikleri bu GenerateKeywordHistoricalMetricsResult ile birleştirilen yakın varyasyonların listesi.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

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

string

Bir veya daha fazla anahtar kelimeyle ilişkili sorgunun metni. Anahtar kelimelerinizi metin olarak döndürmeden önce anahtar kelimeler listenizi tekilleştirdiğimizi ve yakın varyasyonları ortadan kaldırdığımızı unutmayın. Örneğin, isteğiniz başlangıçta "araba" ve "arabalar" anahtar kelimelerini içeriyorsa döndürülen arama sorgusu yalnızca "arabalar"ı içerir. Tekilleştirilmiş sorguların listesi, closeVariants alanına dahil edilir.