Method: customers.generateKeywordHistoricalMetrics

Geçmiş anahtar kelime 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/v16/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

İsteğin gövdesi, aşağıdaki yapıya sahip 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 tam olarak tekilleştirmenin bir sonucu olarak 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

Doğruysa, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer, false (yanlış) değeridir.
geoTargetConstants[]

string

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

enum (KeywordPlanNetwork)

Hedefleme ağı. 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, o kelimelerin 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 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

İstatistikleri bu GenerateKeywordHistoryMetricsResult içinde birleştirilen, istenen anahtar kelimelerdeki yakın varyasyonların listesi.
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ı kaldırarak anahtar kelime listenizdeki yinelenen öğeleri tekilleştirdiğimizi unutmayın. Örneğin, isteğiniz orijinal olarak "otomobil" ve "arabalar" anahtar kelimelerini içeriyorsa döndürülen arama sorgusu yalnızca "otomobiller" ifadesini içerir. Tekilleştirilmiş sorguların listesi closeVariants alanına dahil edilecektir.