- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Deneyin.
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/v15/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ıyla birlikte veriler içerir:
JSON gösterimi |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
Alanlar | |
---|---|
geoTargetConstants[] |
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 |
Politika true (doğru) ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilecektir. Varsayılan değer, false (yanlış) değeridir. |
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 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 |
Ağ hedefleniyor. 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 birleştirilmiş alanlar. |
historicalMetricsOptions |
Geçmiş metrik verilerine yönelik seçenekler. |
language |
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 |
Fikir oluşturmak için bir Anahtar Kelime ve belirli bir URL. Örneğin, arabalar, www.example.com/otomobiller. |
keywordSeed |
Örneğin arabalardan fikir oluşturmak için kullanılan bir Anahtar kelime veya kelime öbeği. |
urlSeed |
Fikir üretilecek belirli bir URL. Örneğin, www.example.com/arabalar. |
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 ( |
Alanlar | |
---|---|
results[] |
Anahtar kelime fikirleri oluşturmanın sonuçları. |
aggregateMetricResults |
Tüm anahtar kelime fikirleri için toplu metrikler. |
nextPageToken |
Sayfalara ayırma jetonu, sonraki sonuç sayfasını almak için kullanılır. Bu dizenin içeriğini, sonraki isteğin |
totalSize |
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[] |
En az bir anahtar kelime gerektirir. |
url |
Anahtar kelime fikirleri oluşturmak için taranacak URL. |
KeywordSeed
Anahtar Kelime Kaynak
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 Tohumu
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 kelimeye ilişkin geçmiş metrikler. |
keywordAnnotations |
Anahtar kelime için ek açıklamalar. Ek açıklama verileri yalnızca istendiğinde sağlanır. |
closeVariants[] |
İ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 |
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 ( |
Alanlar | |
---|---|
concepts[] |
Anahtar kelimeye ilişkin kavramların listesi. |
KeywordConcept
Anahtar kelime kavramı.
JSON gösterimi |
---|
{
"name": string,
"conceptGroup": {
object ( |
Alanlar | |
---|---|
name |
ConceptGroup içindeki anahtar kelimenin kavram adı. |
conceptGroup |
Kavram ayrıntılarının kavram grubu. |
ConceptGroup
Anahtar kelime kavramı için kavram grubu.
JSON gösterimi |
---|
{
"name": string,
"type": enum ( |
Alanlar | |
---|---|
name |
Kavram grubunun adı. |
type |
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. |