Method: customers.generateKeywordHistoricalMetrics

Anahtar kelime geçmiş metriklerinin bir 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/v14/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 içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler 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 anahtar kelime listesi. Neredeyse tama yakın tekilleştirme nedeniyle tüm girişler döndürülmez. Örneğin, "araba" ve "arabalar" için istatistikler istenirse yalnızca "araba" değeri döndürülür. En fazla 10.000 anahtar kelime kullanılabilir.
includeAdultKeywords

boolean

Politika true (doğru) ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilecektir. Varsayılan değer, false (yanlış) değeridir.
geoTargetConstants[]

string

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

enum (KeywordPlanNetwork)

Ağ hedefleniyor. Politika ayarlanmazsa Google Arama ve İş Ortakları Ağı kullanılır.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Yanıta dahil edilecek birleştirilmiş alanlar.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verilerine yönelik seçenekler.
language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime bir dil grubuna aittir; dil, dillerinden biriyse anahtar kelime de 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 kelime listesi ve 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ı makaleye bakın.

GenerateKeywordHistoricalMetricsResult

Geçmiş anahtar kelime metrikleri oluşturmanın sonucu.

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

string

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

object (KeywordPlanHistoricalMetrics)

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

string

Bir veya daha fazla anahtar kelimeyle ilişkilendirilen sorgu metni. Anahtar kelimeleri metin olarak döndürmeden önce, yakın varyasyonları eleyerek anahtar kelime listenizdeki yinelenen öğeleri tekilleştirdiğimizi 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" anahtar kelimesini içerir. Tekilleştirilmiş sorguların listesi, closeVariants alanına dahil edilecektir.