- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- GenerateKeywordHistoricalMetricsResult
- Deneyin.
Geçmiş anahtar kelime metriklerinin bir 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "keywords": [ string ], "includeAdultKeywords": boolean, "geoTargetConstants": [ string ], "keywordPlanNetwork": enum ( |
Alanlar | |
---|---|
keywords[] |
Geçmiş metrikleri almak için anahtar kelime listesi. Neredeyse tam olarak tekilleştirmenin bir sonucu olarak tüm girişler döndürülmez. Örneğin, "araba" ve "arabalar" için istatistikler istenirse yalnızca "araba" değeri döndürülür. En fazla 10.000 anahtar kelime kullanılabilir. |
includeAdultKeywords |
Doğruysa, yetişkinlere uygun anahtar kelimeler yanıta dahil edilir. Varsayılan değer, false (yanlış) değeridir. |
geoTargetConstants[] |
Hedeflenecek konumun kaynak adları. Maksimum sayı 10'dur. Tüm hedefleme coğrafyalarını 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 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, o kelimelerin dillerinden biriyse 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'a Genel Bakış başlıklı makaleye bakın.
GenerateKeywordHistoricalMetricsResult
Geçmiş anahtar kelime metrikleri oluşturmanın sonucu.
JSON gösterimi |
---|
{
"closeVariants": [
string
],
"keywordMetrics": {
object ( |
Alanlar | |
---|---|
closeVariants[] |
İstatistikleri bu GenerateKeywordHistoryMetricsResult içinde birleştirilen, istenen anahtar kelimelerdeki yakın varyasyonların listesi. |
keywordMetrics |
Metin ve yakın varyasyonları için geçmiş metrikler |
text |
Bir veya daha fazla anahtar kelimeyle ilişkilendirilen sorgu metni. Anahtar kelimeleri metin olarak döndürmeden önce, yakın varyasyonları kaldırarak anahtar kelime listenizdeki yinelenen öğeleri tekilleştirdiğimizi unutmayın. Örneğin, isteğiniz orijinal olarak "otomobil" ve "arabalar" anahtar kelimelerini içeriyorsa döndürülen arama sorgusu yalnızca "otomobiller" ifadesini içerir. Tekilleştirilmiş sorguların listesi closeVariants alanına dahil edilecektir. |