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/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

İ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 almaya yönelik anahtar kelime listesi. Neredeyse tam olarak tekilleştirme sonucunda tüm girişler döndürülmez. Örneğin, "araba" ve "arabalar" gibi istenir, yalnızca "car" döndürülecek. En fazla 10.000 anahtar kelime kullanılabilir.
includeAdultKeywords

boolean

Doğru ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer false'tur.
geoTargetConstants[]

string

Hedeflenecek konumun kaynak adları. Maksimum sayı 10'dur. Hedeflenecek tüm coğrafi konumları 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 toplama alanları.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verileriyle ilgili seçenekler.
language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime belirli bir dil grubuna aittir; 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

GenerateKeywordHistoricalMetricsResult

Anahtar kelime geçmiş metrikleri oluşturmanın sonucu.

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

string

İstatistikleri bu GenerateKeywordHistoryMetricsResult öğesinde birleştirilmiş, istenen anahtar kelimelerin yakın varyasyonlarının listesi.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

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

string

Bir veya daha fazla anahtar kelimeyle ilişkili sorgu metni. Anahtar kelime listenizi tekilleştirdiğimizi ve böylece anahtar kelimeleri metin olarak döndürmeden önce yakın varyasyonları kaldırdığımızı unutmayın. Örneğin, isteğiniz orijinal olarak "araba" anahtar kelimelerini içeriyorsa ve "arabalar" anahtar kelimesini içeriyorsa döndürülen arama sorgusu yalnızca "arabalar" kelimesini içerir. Tekilleştirilmiş sorguların listesi, CloseVariants alanına dahil edilecektir.