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/v14/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. Jumlah maksimumnya adalah 10. Daftar kosong MUNGKIN digunakan untuk menentukan semua geografis penargetan.
includeAdultKeywords

boolean

Jika 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. Bidang permintaan harus cocok di seluruh halaman.
pageSize

integer

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

enum (KeywordPlanNetwork)

Penargetan jaringan. Jika tidak disetel, Jaringan Google Penelusuran dan Partner akan digunakan.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Anotasi kata kunci yang 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 merupakan salah satu dari bahasanya. Jika tidak ditetapkan, semua kata kunci akan disertakan.
Kolom union seed. Jenis seed untuk membuat ide kata kunci. seed hanya ada berupa salah satu diantara berikut:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Kata Kunci dan URL spesifik untuk membuat ide misalnya, mobil, www.example.com/cars.
keywordSeed

object (KeywordSeed)

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

object (UrlSeed)

URL spesifik untuk membuat ide, misalnya, www.example.com/cars.
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 pembuatan ide kata kunci.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Metrik gabungan untuk semua ide kata kunci.
nextPageToken

string

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

string (int64 format)

Jumlah total hasil yang tersedia.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • 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 dalam versi ini tidak diketahui.
KEYWORD_CONCEPT Tampilkan data grup konsep dan konsep kata kunci.

KeywordAndUrlSeed

Kata Kunci dan Sumber URL

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

string

Membutuhkan setidaknya satu kata kunci.
url

string

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

KeywordSeed

Sumber Kata Kunci

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

Seed di Lokasi Pembangunan

Representasi JSON 
{
  "site": string
}
Kolom
site

string

Nama domain situs. Jika pelanggan yang meminta ide bukan pemilik situs, maka hanya informasi publik yang 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 mirip dari kata kunci yang diminta yang digabungkan ke dalam GenerateKeywordIdeaResult ini. Lihat https://support.google.com/google-ads/answer/9342105 untuk definisi "varian mirip".
text

string

Teks ide kata kunci. Seperti dalam metrik historis Rencana Kata Kunci, teks ini mungkin bukan kata kunci yang sebenarnya, tetapi merupakan bentuk kanonis dari beberapa kata kunci. Lihat pesan KeywordPlanKeywordKeywordMetrics 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 dalam konsepGroup.
conceptGroup

object (ConceptGroup)

Grup konsep dari 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

Menghitung jenis grup konsep rencana kata kunci.

Enum
UNSPECIFIED Klasifikasi kelompok konsep berbeda dari merek/non-merek. Ini adalah semua kategori untuk semua klasifikasi yang tidak termasuk dalam kategori di bawah.
UNKNOWN Nilai dalam versi ini tidak diketahui.
BRAND Klasifikasi kelompok konsep didasarkan pada BRAND.
OTHER_BRANDS Klasifikasi kelompok konsep berdasarkan BRAND, yang tidak sesuai dengan klasifikasi BRAND. Umumnya ini adalah pencilan dan hanya memiliki sedikit kata kunci dalam jenis klasifikasi ini.
NON_BRAND Klasifikasi kelompok konsep ini tidak didasarkan pada BRAND. Ini ditampilkan untuk kata kunci umum yang tidak memiliki asosiasi merek.