- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Deneyin.
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 |
Ö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 ( |
Alanlar | |
---|---|
geoTargetConstants[] |
Hedeflenecek konumun kaynak adları. Maksimum sayı 10'dur. Hedeflenecek tüm coğrafi konumları belirtmek için boş bir liste KULLANILABİLİR. |
includeAdultKeywords |
Doğru ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer false'tur. |
pageToken |
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 |
pageSize |
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 |
Hedefleme ağı. Politika ayarlanmazsa Google Arama ve İş Ortakları Ağı kullanılır. |
keywordAnnotation[] |
Yanıta dahil edilecek anahtar kelime ek açıklamaları. |
aggregateMetrics |
Yanıta dahil edilecek toplama alanları. |
historicalMetricsOptions |
Geçmiş metrik verileriyle ilgili seçenekler. |
language |
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 |
Örneğin, arabalar, www.example.com/arabalar adresinden fikir oluşturmak için kullanılacak bir Anahtar Kelime ve belirli bir URL. |
keywordSeed |
Örneğin, arabalardan fikir oluşturmak için kullanılan Anahtar Kelime veya kelime öbeği. |
urlSeed |
Fikir üretilecek belirli bir URL, örneğin, www.example.com/arabalar. |
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 ( |
Alanlar | |
---|---|
results[] |
Anahtar kelime fikirleri oluşturmanın sonuçları. |
aggregateMetricResults |
Tüm anahtar kelime fikirleri için toplu metrikler. |
nextPageToken |
Sonuçların sonraki sayfasını almak için kullanılan sayfalara ayırma jetonu. Bu dizenin içeriğini bir sonraki isteğin |
totalSize |
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[] |
En az bir anahtar kelime gerektirir. |
url |
Anahtar kelime fikirleri oluşturmak için taranacak URL. |
KeywordSeed
Anahtar Kelime Başlangıç Noktası
JSON gösterimi |
---|
{ "keywords": [ string ] } |
Alanlar | |
---|---|
keywords[] |
En az bir anahtar kelime gerektirir. |
UrlSeed
URL Başlangıç Noktası
JSON gösterimi |
---|
{ "url": string } |
Alanlar | |
---|---|
url |
Anahtar kelime fikirleri oluşturmak için taranacak URL. |
SiteSeed
Site Başlangıç Noktası
JSON gösterimi |
---|
{ "site": string } |
Alanlar | |
---|---|
site |
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 ( |
Alanlar | |
---|---|
keywordIdeaMetrics |
Anahtar kelimenin geçmiş metrikleri. |
keywordAnnotations |
Anahtar kelimenin ek açıklamaları. Ek açıklama verileri yalnızca istendiğinde sağlanır. |
closeVariants[] |
İ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 |
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 ( |
Alanlar | |
---|---|
concepts[] |
Anahtar kelimeye ilişkin kavramların listesi. |
KeywordConcept
Anahtar kelime kavramı.
JSON gösterimi |
---|
{
"name": string,
"conceptGroup": {
object ( |
Alanlar | |
---|---|
name |
ConceptGroup'taki anahtar kelimenin kavram adı. |
conceptGroup |
Kavram ayrıntılarının kavram grubu. |
ConceptGroup
Anahtar kelime konseptinin kavram grubu.
JSON gösterimi |
---|
{
"name": string,
"type": enum ( |
Alanlar | |
---|---|
name |
Kavram grubu adı. |
type |
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. |