Method: customers.generateKeywordIdeas

Anahtar kelime fikirlerinden oluşan bir liste 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

İstek gövdesi, aşağıdaki yapıya sahip verileri 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. Hedeflenecek tüm coğrafi konumları belirtmek için boş bir liste KULLANILABİLİR.

includeAdultKeywords

boolean

Doğru ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer false'tur.

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 öğesinden 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 yoksayılır. Belirtilmezse en fazla 10.000 sonuç döndürülür. Sunucu, döndürülen kaynakların sayısını daha fazla 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 toplama alanları.

historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verileriyle ilgili seçenekler.

language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime belirli bir dil grubuna aittir; anahtar kelime dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.

Birleştirme alanı seed. Anahtar kelime fikirleri oluşturmak için kullanılan başlangıç noktası türü. seed şunlardan yalnızca biri olabilir:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Örneğin, arabalar, www.example.com/arabalar adresinden fikir oluşturmak için kullanılacak bir Anahtar Kelime ve belirli bir URL.

keywordSeed

object (KeywordSeed)

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

urlSeed

object (UrlSeed)

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

siteSeed

object (SiteSeed)

Fikirlerin oluşturulacağı site (ör. 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

Sonuçların sonraki sayfasını almak için kullanılan sayfalara ayırma jetonu. Bu dizenin içeriğini bir sonraki isteğin pageToken özelliği olarak aktarın. nextPageToken, son sayfa için döndürülmedi.

totalSize

string (int64 format)

Toplam mevcut 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

KeywordPlanKeywordAnnotation

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

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

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 oluşturmanın 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 kelimenin ek açıklamaları. Ek açıklama verileri yalnızca istendiğinde sağlanır.

closeVariants[]

string

İstenen anahtar kelimelerin yakın varyasyonlarından oluşan ve bu GenerateKeywordIdeaResult'da birleştirilen liste. "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 fazla anahtar kelimenin standart biçimi olabilir. KeywordPlanService'te KeywordPlanKeywordHistoryMetrics mesajını görüntüleyin.

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'taki anahtar kelimenin kavram adı.

conceptGroup

object (ConceptGroup)

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

ConceptGroup

Anahtar kelime konseptinin 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 belirtir.

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