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/v16/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

İsteğin gövdesi, aşağıdaki yapıya sahip 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 sayı 10'dur. Tüm hedefleme coğrafyalarını belirtmek için boş bir liste KULLANILABİLİR.
includeAdultKeywords

boolean

Doğruysa, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. 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 adresinden alınan 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 bu değeri aşarsa yok sayılır. Belirtilmemesi durumunda en fazla 10.000 sonuç döndürülür. Sunucu, döndürülen kaynak sayısını daha da sınırlandırmaya karar verebilir. Yanıt 10.000'den az sonuç içeriyorsa son sonuç sayfası olarak kabul edilmeyebilir.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Hedefleme ağı. 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, o kelimelerin dillerinden biriyse anahtar kelime dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.
Birleştirme alanı seed. Anahtar kelime fikirleri oluşturmak için kullanılan kaynak türü. seed şunlardan yalnızca biri olabilir:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

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

object (KeywordSeed)

Örneğin, arabalardan fikir oluşturmaya yarayan bir Anahtar Kelime veya kelime öbeği.
urlSeed

object (UrlSeed)

Fikir oluşturulacak belirli bir URL. Örneğin, www.example.com/arabalar.
siteSeed

object (SiteSeed)

Fikirlerin oluşturulacağı 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

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

string (int64 format)

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ürür.

KeywordAndUrlSeed

Anahtar Kelime ve URL Başlangıç Noktası

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 Başlangıç Noktası

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 Başlangıç Noktası

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 üretmenin sonucu.

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

object (KeywordPlanHistoricalMetrics)

Anahtar kelimenin geçmiş metrikleri.
keywordAnnotations

object (KeywordAnnotations)

Anahtar kelimeye ilişkin ek açıklamalar. Ek açıklama verileri yalnızca istenirse sağlanır.
closeVariants[]

string

Bu GenerateKeywordIdeaResult'da birleştirilen, istenen anahtar kelimelerdeki yakın varyasyonların listesi. "Yakın varyasyonlar"ın tanımı için https://support.google.com/google-ads/answer/9342105 adresine bakın.
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 çok anahtar kelimenin standart biçimi olabilir. KeywordPlanService'te KeywordPlanKeywordHistoryMetrikler mesajına bakın.

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 kavram listesi.

KeywordConcept

Anahtar kelimenin konsepti.

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ına ilişkin kavram grubu.

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

string

Kavram grubu 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 olmayan kategorisinden farklı. Bu, aşağıdakilerden hiçbiri olmayan tüm sınıflandırmalar için bir bütün grubu yakalar.
UNKNOWN Değer, bu sürümde bilinmiyor.
BRAND Kavram grubu sınıflandırması, BRAND türünü temel alır.
OTHER_BRANDS BRAND markasına dayalı, BRAND sınıflandırmalarına pek 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 değerine dayalı değildir. Bu değer, marka ilişkilendirmesi olmayan genel anahtar kelimeler için döndürülür.