Method: customers.generateKeywordIdeas

Anahtar kelime fikirlerinin bir listesini döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Öneriyi içeren müşterinin kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
geoTargetConstants[]

string

Hedeflenecek konumun kaynak adları. Maksimum değer 10'dur. Tüm hedefleme coğrafi alanlarını belirtmek için boş bir liste KULLANILABİLİR.
includeAdultKeywords

boolean

Politika true (doğru) ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilecektir. Varsayılan değer, false (yanlış) değeridir.
pageToken

string

Alınacak sayfanın jetonu. Belirtilmezse sonuçların ilk sayfası döndürülür. Sonuçların sonraki sayfasını istemek için önceki yanıtta nextPageToken özelliğinden elde ettiğiniz değeri kullanın. İstek alanları tüm sayfalarda eşleşmelidir.
pageSize

integer

Tek bir sayfada alınacak sonuç sayısı. En fazla 10.000 sonuç döndürülebilir. pageSize değeri bunu aşarsa yok sayılır. Belirtilmemişse en fazla 10.000 sonuç döndürülür. Sunucu, döndürülen kaynakların sayısını daha fazla sınırlamaya karar verebilir. Yanıt 10.000'den az sonuç içeriyorsa son sonuç sayfası olarak kabul edilmeyebilir.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Ağ hedefleniyor. Politika ayarlanmazsa Google Arama ve İş Ortakları Ağı kullanılır.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Yanıta dahil edilecek anahtar kelime ek açıklamaları.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Yanıta dahil edilecek birleştirilmiş alanlar.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verilerine yönelik seçenekler.
language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime bir dil grubuna aittir; dil, dillerinden biriyse anahtar kelime de dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.
seed alanı. Anahtar kelime fikirleri oluşturulacak başlangıç noktası türü. seed şunlardan yalnızca biri olabilir:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Fikir oluşturmak için bir Anahtar Kelime ve belirli bir URL. Örneğin, arabalar, www.example.com/otomobiller.
keywordSeed

object (KeywordSeed)

Örneğin arabalardan fikir oluşturmak için kullanılan bir Anahtar kelime veya kelime öbeği.
urlSeed

object (UrlSeed)

Fikir üretilecek belirli bir URL. Örneğin, www.example.com/arabalar.
siteSeed

object (SiteSeed)

Fikir alınacak site, örneğin, www.example.com.

Yanıt gövdesi

KeywordPlanIdeaService.GenerateKeywordIdeas için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Alanlar
results[]

object (GenerateKeywordIdeaResult)

Anahtar kelime fikirleri oluşturmanın sonuçları.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Tüm anahtar kelime fikirleri için toplu metrikler.
nextPageToken

string

Sayfalara ayırma jetonu, sonraki sonuç sayfasını almak için kullanılır. Bu dizenin içeriğini, sonraki isteğin pageToken özelliği olarak iletin. nextPageToken, son sayfa için döndürülmez.
totalSize

string (int64 format)

Mevcut toplam sonuç sayısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

KeywordPlanKeywordAnnotation

İstenebilecek anahtar kelime planı ek açıklamalarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Değer bu sürümde bilinmiyor.
KEYWORD_CONCEPT Anahtar kelime kavramı ve kavram grubu verilerini döndürme.

KeywordAndUrlSeed

Anahtar Kelime ve URL Kaynak

JSON gösterimi 
{
  "keywords": [
    string
  ],
  "url": string
}
Alanlar
keywords[]

string

En az bir anahtar kelime gerektirir.
url

string

Anahtar kelime fikirleri oluşturmak için taranacak URL.

KeywordSeed

Anahtar Kelime Kaynak

JSON gösterimi 
{
  "keywords": [
    string
  ]
}
Alanlar
keywords[]

string

En az bir anahtar kelime gerektirir.

UrlSeed

URL Başlangıç Noktası

JSON gösterimi 
{
  "url": string
}
Alanlar
url

string

Anahtar kelime fikirleri oluşturmak için taranacak URL.

SiteSeed

Site Tohumu

JSON gösterimi 
{
  "site": string
}
Alanlar
site

string

Sitenin alan adı. Fikirleri talep eden müşteri sitenin sahibi değilse yalnızca herkese açık bilgiler döndürülür.

GenerateKeywordIdeaResult

Anahtar kelime fikirleri oluşturmanın sonucu.

JSON gösterimi 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
Alanlar
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

Anahtar kelimeye ilişkin geçmiş metrikler.
keywordAnnotations

object (KeywordAnnotations)

Anahtar kelime için ek açıklamalar. Ek açıklama verileri yalnızca istendiğinde sağlanır.
closeVariants[]

string

İstenen anahtar kelimelerden gelen ve bu GenerateKeywordIdeaResult'da birleştirilen yakın varyasyonların listesi. "Yakın varyasyonlar"ın tanımı için https://support.google.com/google-ads/answer/9342105 adresini ziyaret edin.
text

string

Anahtar kelime fikrinin metni. Anahtar Kelime Planı geçmiş metriklerinde olduğu gibi, bu metin gerçek bir anahtar kelime değil, birden fazla anahtar kelimenin standart biçimi olabilir. KeywordPlanService'te KeywordPlanKeywordHistoryMetrics mesajı görüntülenir.

KeywordAnnotations

Anahtar kelime planı anahtar kelimeleri için ek açıklamalar.

JSON gösterimi 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Alanlar
concepts[]

object (KeywordConcept)

Anahtar kelimeye ilişkin kavramların listesi.

KeywordConcept

Anahtar kelime kavramı.

JSON gösterimi 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Alanlar
name

string

ConceptGroup içindeki anahtar kelimenin kavram adı.
conceptGroup

object (ConceptGroup)

Kavram ayrıntılarının kavram grubu.

ConceptGroup

Anahtar kelime kavramı için kavram grubu.

JSON gösterimi 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Alanlar
name

string

Kavram grubunun adı.
type

enum (KeywordPlanConceptGroupType)

Kavram grubu türü.

KeywordPlanConceptGroupType

Anahtar kelime planı kavram grubu türlerini sıralar.

Sıralamalar
UNSPECIFIED Kavram grubu sınıflandırması, marka/marka dışı kategorisinden farklı. Bu, aşağıdakilerden hiçbiri olmayan tüm sınıflandırmalar için bir tümünü yakalama grubudur.
UNKNOWN Değer bu sürümde bilinmiyor.
BRAND Kavram grubu sınıflandırması, MARKA temel alınarak yapılır.
OTHER_BRANDS MARKA temelli ve BRAND sınıflandırmalarına uygun olmayan kavram grubu sınıflandırması. Bunlar genellikle aykırı değerlerdir ve bu tür sınıflandırmada çok az anahtar kelime içerebilir.
NON_BRAND Bu kavram grubu sınıflandırması, BRAND markasına dayalı değildir. Bu değer, marka ilişkilendirmesi olmayan genel anahtar kelimeler için döndürülür.