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/v16/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 dikembalikan, jika pageSize melebihi ini, itu akan diabaikan. Jika tidak ditentukan, maksimal 10.000 hasil akan ditampilkan. Server dapat memutuskan untuk membatasi lebih lanjut jumlah resource yang ditampilkan. Jika respons berisi kurang dari 10.000 hasil,respons tersebut mungkin tidak dianggap sebagai halaman terakhir hasil.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

Anotasi kata kunci yang akan disertakan dalam respons.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Kolom agregat yang akan disertakan dalam respons.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opsi untuk data metrik historis.
language

string

Nama resource bahasa yang akan ditargetkan. Setiap kata kunci berasal dari beberapa kumpulan bahasa; kata kunci akan disertakan jika bahasa merupakan salah satu bahasanya. Jika tidak ditetapkan, semua kata kunci akan disertakan.
Kolom union seed. Jenis inti untuk menghasilkan ide kata kunci. seed hanya ada berupa salah satu diantara berikut:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

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

object (KeywordSeed)

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

object (UrlSeed)

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

object (SiteSeed)

Situs tempat Anda 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 dari 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 Menampilkan data konsep kata kunci dan grup konsep.

KeywordAndUrlSeed

Sumber Kata Kunci dan URL

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

string

Memerlukan 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

Memerlukan 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 Lokasi Pembangunan

Representasi JSON 
{
  "site": string
}
Kolom
site

string

Nama domain situs. Jika pelanggan yang meminta ide bukan pemilik 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 mirip dari kata kunci yang diminta yang digabungkan ke GenerateKeywordIdeaResult ini. Lihat https://support.google.com/google-ads/answer/9342105 untuk mengetahui 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 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 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

Menjelaskan jenis grup konsep rencana kata kunci.

Enum
UNSPECIFIED Klasifikasi grup konsep berbeda dari merek/non-merek. Ini adalah kategori generik untuk semua klasifikasi yang tidak termasuk dalam kategori di bawah.
UNKNOWN Nilai dalam versi ini tidak diketahui.
BRAND Klasifikasi grup konsep didasarkan pada BRAND.
OTHER_BRANDS Klasifikasi kelompok konsep berdasarkan BRAND, yang tidak sesuai dengan klasifikasi BRAND. Hal tersebut biasanya merupakan outlier dan dapat memiliki sangat 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.