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 ditargetkan. Maksimum 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 jumlah ini, pageSize 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)

Jaringan penargetan. 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 tertentu untuk menghasilkan ide, misalnya, mobil, www.example.com/cars.
keywordSeed

object (KeywordSeed)

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

object (UrlSeed)

URL tertentu untuk menghasilkan ide, misalnya, www.example.com/cars.
siteSeed

object (SiteSeed)

Situs yang akan digunakan untuk menghasilkan 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 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 mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

KeywordPlanKeywordAnnotation

Menghitung anotasi rencana kata kunci yang dapat diminta.

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

KeywordAndUrlSeed

Kata Kunci dan Seed URL

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

string

Memerlukan minimal satu kata kunci dan maksimal 20 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

Memerlukan minimal satu kata kunci dan maksimal 20 kata kunci.

UrlSeed

Benih URL

Representasi JSON 
{
  "url": string
}
Kolom
url

string

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

SiteSeed

Seed Situs

Representasi JSON 
{
  "site": string
}
Kolom
site

string

Nama domain situs. Jika pelanggan yang meminta ide tidak memiliki situs yang disediakan, hanya informasi publik yang akan ditampilkan.

GenerateKeywordIdeaResult

Hasil 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 KeywordPlanKeywordHistoricalMetrics 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 bucket generik untuk semua klasifikasi yang tidak termasuk dalam kategori di bawah.
UNKNOWN Nilai tidak diketahui dalam versi ini.
BRAND Klasifikasi grup konsep didasarkan pada BRAND.
OTHER_BRANDS Klasifikasi grup konsep berdasarkan BRAND, yang tidak sesuai dengan klasifikasi BRAND. Jenis ini biasanya merupakan outlier dan dapat memiliki sangat sedikit kata kunci dalam jenis klasifikasi ini.
NON_BRAND Klasifikasi grup konsep ini tidak didasarkan pada BRAND. Ini ditampilkan untuk kata kunci generik yang tidak memiliki pengaitan merek.