- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- GenerateKeywordHistoricalMetricsResult
- Deneyin.
Anahtar kelime geçmiş metriklerinin listesini döndürür.
Atılan hataların listesi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP isteği
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordHistoricalMetrics
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 |
---|
{ "keywords": [ string ], "includeAdultKeywords": boolean, "geoTargetConstants": [ string ], "keywordPlanNetwork": enum ( |
Alanlar | |
---|---|
keywords[] |
Geçmiş metrikleri almaya yönelik anahtar kelime listesi. Neredeyse tam olarak tekilleştirme sonucunda tüm girişler döndürülmez. Örneğin, "araba" ve "arabalar" gibi istenir, yalnızca "car" döndürülecek. En fazla 10.000 anahtar kelime kullanılabilir. |
includeAdultKeywords |
Doğru ise, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer false'tur. |
geoTargetConstants[] |
Hedeflenecek konumun kaynak adları. Maksimum sayı 10'dur. Hedeflenecek tüm coğrafi konumları belirtmek için boş bir liste KULLANILABİLİR. |
keywordPlanNetwork |
Hedefleme ağı. Politika ayarlanmazsa Google Arama ve İş Ortakları Ağı kullanılır. |
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. |
Yanıt gövdesi
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
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 listesi ve geçmiş metrikleri. |
aggregateMetricResults |
Tüm anahtar kelimeler için toplu metrikler. |
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.
GenerateKeywordHistoricalMetricsResult
Anahtar kelime geçmiş metrikleri oluşturmanın sonucu.
JSON gösterimi |
---|
{
"closeVariants": [
string
],
"keywordMetrics": {
object ( |
Alanlar | |
---|---|
closeVariants[] |
İstatistikleri bu GenerateKeywordHistoryMetricsResult öğesinde birleştirilmiş, istenen anahtar kelimelerin yakın varyasyonlarının listesi. |
keywordMetrics |
Metin ve yakın varyasyonları için geçmiş metrikler |
text |
Bir veya daha fazla anahtar kelimeyle ilişkili sorgu metni. Anahtar kelime listenizi tekilleştirdiğimizi ve böylece anahtar kelimeleri metin olarak döndürmeden önce yakın varyasyonları kaldırdığımızı unutmayın. Örneğin, isteğiniz orijinal olarak "araba" anahtar kelimelerini içeriyorsa ve "arabalar" anahtar kelimesini içeriyorsa döndürülen arama sorgusu yalnızca "arabalar" kelimesini içerir. Tekilleştirilmiş sorguların listesi, CloseVariants alanına dahil edilecektir. |