Method: customers.generateKeywordIdeas

Menampilkan daftar ide kata kunci.

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

Permintaan HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordIdeas

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 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Kolom
geoTargetConstants[]

string

Nama resource lokasi yang akan ditarget. Maksimumnya 10. Daftar kosong DAPAT digunakan untuk menentukan semua geo penargetan.
includeAdultKeywords

boolean

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

string

Token halaman yang akan diambil. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan. Untuk meminta halaman hasil berikutnya, gunakan nilai yang diperoleh dari nextPageToken dalam respons sebelumnya. Kolom permintaan harus cocok di seluruh halaman.
pageSize

integer

Jumlah hasil yang akan diambil dalam satu halaman. Maksimal 10.000 hasil dapat ditampilkan. Jika pageSize melebihi batas ini, hasil akan diabaikan. Jika tidak ditentukan, maksimal 10.000 hasil akan ditampilkan. Server dapat memutuskan untuk lebih membatasi jumlah resource yang ditampilkan. Jika respons berisi kurang dari 10.000 hasil, respons tersebut mungkin tidak dianggap sebagai halaman hasil terakhir.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Menargetkan jaringan. Jika tidak ditetapkan, Jaringan Google Penelusuran dan Partner akan digunakan.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Anotasi kata kunci yang akan disertakan dalam respons.
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.
Kolom union seed. Jenis kata kunci awal untuk menghasilkan ide kata kunci. seed hanya dapat berupa salah satu dari berikut:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Kata kunci dan URL spesifik untuk menghasilkan ide misalnya, mobil, www.example.com/mobil.
keywordSeed

object (KeywordSeed)

Kata kunci atau frasa untuk menghasilkan ide, misalnya, mobil.
urlSeed

object (UrlSeed)

URL spesifik untuk membuat ide, misalnya, www.example.com/mobil.
siteSeed

object (SiteSeed)

Situs untuk membuat ide, misalnya, www.example.com.

Isi respons

Pesan respons untuk KeywordPlanIdeaService.GenerateKeywordIdeas.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Kolom
results[]

object (GenerateKeywordIdeaResult)

Hasil dari pembuatan ide kata kunci.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Metrik gabungan untuk semua ide kata kunci.
nextPageToken

string

Token penomoran halaman yang digunakan untuk mengambil halaman hasil berikutnya. Teruskan konten string ini sebagai atribut pageToken dari permintaan berikutnya. nextPageToken tidak ditampilkan untuk halaman terakhir.
totalSize

string (int64 format)

Jumlah total hasil yang tersedia.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

KeywordPlanKeywordAnnotation

Menghitung anotasi rencana kata kunci yang dapat diminta.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
KEYWORD_CONCEPT Menampilkan data konsep kata kunci dan grup konsep.

KeywordAndUrlSeed

Seed Kata Kunci dan URL

Representasi JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
Kolom
keywords[]

string

Memerlukan minimal satu kata kunci.
url

string

URL yang akan di-crawl untuk menghasilkan ide kata kunci.

KeywordSeed

Kata Kunci Induk

Representasi JSON 
{
  "keywords": [
    string
  ]
}
Kolom
keywords[]

string

Membutuhkan setidaknya satu kata kunci.

UrlSeed

Seed URL

Representasi JSON 
{
  "url": string
}
Kolom
url

string

URL yang akan di-crawl untuk menghasilkan ide kata kunci.

SiteSeed

Pendanaan Awal

Representasi JSON 
{
  "site": string
}
Kolom
site

string

Nama domain situs. Jika pelanggan yang meminta ide bukan pemilik situs, hanya informasi publik yang akan ditampilkan.

GenerateKeywordIdeaResult

Hasil dari pembuatan ide kata kunci.

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

object (KeywordPlanHistoricalMetrics)

Metrik historis untuk kata kunci.
keywordAnnotations

object (KeywordAnnotations)

Anotasi untuk kata kunci. Data anotasi hanya diberikan jika diminta.
closeVariants[]

string

Daftar varian yang mirip dari kata kunci yang diminta yang digabungkan ke dalam GenerateKeywordIdeaResult ini. Lihat https://support.google.com/google-ads/answer/9342105 untuk mengetahui definisi "varian yang mirip".
text

string

Teks ide kata kunci. Seperti dalam metrik historis Rencana Kata Kunci, teks ini mungkin bukan kata kunci sebenarnya, tetapi bentuk kanonis dari beberapa kata kunci. Lihat pesan KeywordPlanKeywordHistoryMetrics di KeywordPlanService.

KeywordAnnotations

Anotasi untuk kata kunci rencana kata kunci.

Representasi JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Kolom
concepts[]

object (KeywordConcept)

Daftar konsep untuk kata kunci.

KeywordConcept

Konsep untuk kata kunci.

Representasi JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Kolom
name

string

Nama konsep untuk kata kunci di conceptGroup.
conceptGroup

object (ConceptGroup)

Grup konsep detail konsep.

ConceptGroup

Grup konsep untuk konsep kata kunci.

Representasi JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Kolom
name

string

Nama grup konsep.
type

enum (KeywordPlanConceptGroupType)

Jenis grup konsep.

KeywordPlanConceptGroupType

Mencantumkan jenis grup konsep rencana kata kunci.

Enum
UNSPECIFIED Klasifikasi grup konsep berbeda dengan merek/non-merek. Ini adalah kumpulan semua kategori untuk semua klasifikasi yang tidak termasuk di bawah ini.
UNKNOWN Nilai tidak diketahui dalam versi ini.
BRAND Klasifikasi grup konsep didasarkan pada BRAND.
OTHER_BRANDS Klasifikasi kelompok konsep berdasarkan BRAND, yang tidak sesuai dengan klasifikasi BRAND. Ini umumnya adalah pencilan dan dapat memiliki sangat sedikit kata kunci dalam jenis klasifikasi ini.
NON_BRAND Klasifikasi kelompok konsep ini tidak didasarkan pada BRAND. Nilai ini ditampilkan untuk kata kunci generik yang tidak memiliki pengaitan merek.