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/v18/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 penghapusan duplikat yang hampir sama. Misalnya, jika statistik untuk "mobil" dan "mobil-mobil" diminta, hanya "mobil" yang akan ditampilkan. Maksimum 10.000 kata kunci dapat digunakan.
includeAdultKeywords

boolean

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

string

Nama resource lokasi yang akan ditargetkan. Maksimum 10. Daftar kosong DAPAT digunakan untuk menentukan semua geo penargetan.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Jaringan penargetan. Jika tidak ditetapkan, 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 adalah salah satu 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:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Hasil pembuatan metrik historis kata kunci.

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

string

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

object (KeywordPlanHistoricalMetrics)

Metrik historis untuk teks dan variannya yang mirip
text

string

Teks kueri yang terkait dengan satu atau beberapa kata kunci. Perhatikan bahwa kami menghapus duplikat daftar kata kunci Anda, sehingga varian yang mirip akan dihapus 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.