Method: customers.generateKeywordIdeas

Anahtar kelime fikirlerinin 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/v18/customers/{customerId}:generateKeywordIdeas

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

Yol parametreleri

Parametreler
customerId

string

Öneri alan müşterinin kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte 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 10'dur. Tüm hedefleme coğrafi bölgelerini belirtmek için boş bir liste KULLANILABİLİR.

includeAdultKeywords

boolean

Doğru ise yetişkinlere yönelik anahtar kelimeler yanıta dahil edilir. Varsayılan değer false (yanlış) değerini alır.

pageToken

string

Alınacak sayfanın jetonu. Belirtilmemişse sonuçların ilk sayfası döndürülür. Sonuçların bir sonraki sayfasını istemek için önceki yanıttaki nextPageToken değerini kullanın. İstek alanları sayfalar arasında eşleşmelidir.

pageSize

integer

Tek bir sayfada alınacak sonuç sayısı. Maksimum 10.000 sonuç döndürülebilir. pageSize bunu aşarsa yoksayı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 da sınırlamaya karar verebilir. Yanıt 10.000'den az sonuç içeriyorsa sonuçların son sayfası olarak kabul edilmeyebilir.

keywordPlanNetwork

enum (KeywordPlanNetwork)

Hedefleme ağı. Ayarlanmazsa Google Arama ve İş Ortağı Ağı kullanılır.

keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Yanıta eklenecek anahtar kelime ek açıklamaları.

aggregateMetrics

object (KeywordPlanAggregateMetrics)

Yanıta dahil edilecek toplu alanlar.

historicalMetricsOptions

object (HistoricalMetricsOptions)

Geçmiş metrik verileri için seçenekler.

language

string

Hedeflenecek dilin kaynak adı. Her anahtar kelime belirli bir dil grubuna aittir. Dil, anahtar kelimenin dillerinden biriyse anahtar kelime dahil edilir. Ayarlanmazsa tüm anahtar kelimeler dahil edilir.

Birlik alanı seed. Anahtar kelime fikirleri oluşturmak için kullanılacak başlangıç kelimesinin türü. seed yalnızca aşağıdakilerden biri olabilir:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Anahtar kelime ve fikir üretmek için kullanılacak belirli bir URL (ör. arabalar, www.example.com/arabalar).

keywordSeed

object (KeywordSeed)

Örneğin, arabalar hakkında fikir üretmek için kullanabileceğiniz bir anahtar kelime veya kelime öbeği.

urlSeed

object (UrlSeed)

Fikir üretmek için kullanılacak belirli bir URL (ör. www.example.com/arabalar).

siteSeed

object (SiteSeed)

Fikir oluşturmak için kullanılacak 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şturma işleminin sonuçları.

aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Tüm anahtar kelime fikirlerinin toplu metrikleri.

nextPageToken

string

Sonuçların bir sonraki 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)

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 Overview sayfasına bakın.

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

Anahtar Kelime ve URL Başlangıç Numarası

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

string

En az bir anahtar kelime ve en fazla 20 anahtar kelime gereklidir.

url

string

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

KeywordSeed

Anahtar Kelime Tohumu

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

string

En az bir anahtar kelime ve en fazla 20 anahtar kelime gereklidir.

UrlSeed

URL Tohumu

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

string

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

SiteSeed

Site Başlangıç Numarası

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

string

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

GenerateKeywordIdeaResult

Anahtar kelime fikirleri oluşturma işleminin 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 ait ek açıklamalar. Ek açıklama verileri yalnızca istenirse sağlanır.

closeVariants[]

string

İstekte bulunulan anahtar kelimelerden bu GenerateKeywordIdeaResult ile birleştirilen yakın varyasyonların listesi. "Yakın varyantlar"ı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 KeywordPlanKeywordHistoricalMetrics mesajını inceleyin.

KeywordAnnotations

Anahtar kelime planı anahtar kelimeleriyle ilgili ek açıklamalar.

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

object (KeywordConcept)

Anahtar kelimeyle ilgili kavramların listesi.

KeywordConcept

Anahtar kelimenin kavramı.

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

string

conceptGroup'daki anahtar kelimenin kavram adı.

conceptGroup

object (ConceptGroup)

Kavram ayrıntılarının bulunduğu kavram grubu.

ConceptGroup

Anahtar kelime kavramının 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 listeler.

Sıralamalar
UNSPECIFIED Marka/marka dışı kategorisinden farklı bir kavram grubu sınıflandırması. Bu, aşağıdakilerden hiçbiri olmayan tüm sınıflandırmalar için kapsayıcı bir gruptur.
UNKNOWN Değer bu sürümde bilinmiyor.
BRAND Kavram grubu sınıflandırması MARKA'ya dayanır.
OTHER_BRANDS MARKA'ya dayalı kavram grubu sınıflandırması, MARKA sınıflandırmalarına uygun değildi. Bunlar genellikle aykırı değerlerdir ve bu tür bir sınıflandırmada çok az anahtar kelimeye sahip olabilir.
NON_BRAND Bu kavram grubu sınıflandırması MARKA'ya dayalı değildir. Bu değer, marka ilişkilendirmesi olmayan genel anahtar kelimeler için döndürülür.