- 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 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 |
Ö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 ( |
Alanlar | |
---|---|
geoTargetConstants[] |
Hedeflenecek konumun kaynak adları. Maksimum 10'dur. Tüm hedefleme coğrafi bölgelerini belirtmek için boş bir liste KULLANILABİLİR. |
includeAdultKeywords |
Doğru ise yetişkinlere yönelik anahtar kelimeler yanıta dahil edilir. Varsayılan değer false (yanlış) değerini alır. |
pageToken |
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 |
pageSize |
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 |
Hedefleme ağı. Ayarlanmazsa Google Arama ve İş Ortağı Ağı kullanılır. |
keywordAnnotation[] |
Yanıta eklenecek anahtar kelime ek açıklamaları. |
aggregateMetrics |
Yanıta dahil edilecek toplu alanlar. |
historicalMetricsOptions |
Geçmiş metrik verileri için seçenekler. |
language |
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 |
Anahtar kelime ve fikir üretmek için kullanılacak belirli bir URL (ör. arabalar, www.example.com/arabalar). |
keywordSeed |
Örneğin, arabalar hakkında fikir üretmek için kullanabileceğiniz bir anahtar kelime veya kelime öbeği. |
urlSeed |
Fikir üretmek için kullanılacak belirli bir URL (ör. www.example.com/arabalar). |
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 ( |
Alanlar | |
---|---|
results[] |
Anahtar kelime fikirleri oluşturma işleminin sonuçları. |
aggregateMetricResults |
Tüm anahtar kelime fikirlerinin toplu metrikleri. |
nextPageToken |
Sonuçların bir sonraki sayfasını almak için kullanılan sayfalandırma jetonu. Bu dizenin içeriğini bir 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 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[] |
En az bir anahtar kelime ve en fazla 20 anahtar kelime gereklidir. |
url |
Anahtar kelime fikirleri oluşturmak için taranacak URL. |
KeywordSeed
Anahtar Kelime Tohumu
JSON gösterimi |
---|
{ "keywords": [ string ] } |
Alanlar | |
---|---|
keywords[] |
En az bir anahtar kelime ve en fazla 20 anahtar kelime gereklidir. |
UrlSeed
URL Tohumu
JSON gösterimi |
---|
{ "url": string } |
Alanlar | |
---|---|
url |
Anahtar kelime fikirleri oluşturmak için taranacak URL. |
SiteSeed
Site Başlangıç Numarası
JSON gösterimi |
---|
{ "site": string } |
Alanlar | |
---|---|
site |
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 ( |
Alanlar | |
---|---|
keywordIdeaMetrics |
Anahtar kelimenin geçmiş metrikleri. |
keywordAnnotations |
Anahtar kelimeye ait ek açıklamalar. Ek açıklama verileri yalnızca istenirse sağlanır. |
closeVariants[] |
İ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 |
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 ( |
Alanlar | |
---|---|
concepts[] |
Anahtar kelimeyle ilgili kavramların listesi. |
KeywordConcept
Anahtar kelimenin kavramı.
JSON gösterimi |
---|
{
"name": string,
"conceptGroup": {
object ( |
Alanlar | |
---|---|
name |
conceptGroup'daki anahtar kelimenin kavram adı. |
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 ( |
Alanlar | |
---|---|
name |
Kavram grubu adı. |
type |
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. |