Method: customers.generateKeywordHistoricalMetrics

Menampilkan daftar metrik historis kata kunci.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID pelanggan dengan rekomendasi.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

string

Daftar kata kunci untuk mendapatkan metrik historis. Tidak semua input akan ditampilkan sebagai hasil dari penghapusan duplikat yang hampir sama persis. Misalnya, jika statistik untuk "mobil" dan "mobil" diminta, hanya "mobil" yang akan ditampilkan. Anda dapat menggunakan maksimum 10.000 kata kunci.
includeAdultKeywords

boolean

Jika benar, kata kunci dewasa akan disertakan dalam respons. Nilai defaultnya adalah false.
geoTargetConstants[]

string

Nama resource lokasi yang akan ditargetkan. Jumlah maksimumnya adalah 10. Daftar kosong MUNGKIN digunakan untuk menentukan semua geografis penargetan.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Penargetan jaringan. Jika tidak disetel, Jaringan Google Penelusuran dan Partner akan digunakan.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Kolom gabungan yang akan disertakan dalam respons.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opsi untuk data metrik historis.
language

string

Nama resource bahasa yang akan ditargetkan. Setiap kata kunci termasuk dalam beberapa kumpulan bahasa; kata kunci akan disertakan jika bahasa merupakan salah satu dari bahasanya. Jika tidak ditetapkan, semua kata kunci akan disertakan.

Isi respons

Pesan respons untuk KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Kolom
results[]

object (GenerateKeywordHistoricalMetricsResult)

Daftar kata kunci dan metrik historisnya.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Metrik gabungan untuk semua kata kunci.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GenerateKeywordHistoricalMetricsResult

Hasil pembuatan metrik historis kata kunci.

Representasi JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Kolom
closeVariants[]

string

Daftar varian mirip dari kata kunci yang diminta yang statistiknya digabungkan ke dalam GenerateKeywordHistoriMetricsResult ini.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Metrik historis untuk teks dan varian miripnya
text

string

Teks kueri yang terkait dengan satu atau beberapa kata kunci. Perhatikan bahwa kami menghapus duplikat daftar kata kunci Anda, sehingga menghapus varian yang mirip sebelum menampilkan kata kunci sebagai teks. Misalnya, jika permintaan Anda awalnya berisi kata kunci "mobil" dan "mobil", kueri penelusuran yang ditampilkan hanya akan berisi "mobil". Daftar kueri yang dihapus duplikatnya akan disertakan dalam kolom closeVariants.