Google Ads API varlıklarını ve raporlama verilerini almak için aşağıdaki yöntemlerden birini kullanın:
İki yöntem arasındaki temel farklar aşağıda açıklanmıştır:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Üretim kodu için uygundur | Evet | Evet |
| Hizmet | GoogleAdsService |
GoogleAdsService |
| Senaryo | Nesneleri ve raporları getirme | Nesneleri ve raporları getirme |
| Yanıt | GoogleAdsRow nesnelerinin aktarımı |
GoogleAdsRow nesnelerinin bulunduğu sayfalar |
| Yanıtın alanları | Yalnızca sorguda belirtilenler | Yalnızca sorguda belirtilenler |
| Günlük sınırlar | Erişim düzeylerine göre günlük sınırlamalar | Erişim düzeylerine göre günlük sınırlamalar |
SearchStream ve Search karşılaştırması
Search, raporun tamamını indirmek için birden fazla sayfaya bölünmüş istek gönderebilirken SearchStream tek bir istek gönderir ve rapor boyutundan bağımsız olarak Google Ads API ile kalıcı bir bağlantı başlatır.
SearchStream için veri paketleri hemen indirilmeye başlar ve sonucun tamamı bir veri arabelleğine önbelleğe alınır. Kodunuz, aktarımın tamamını beklemek zorunda kalmadan arabelleğe alınan verileri okumaya başlayabilir.
Uygulamanıza bağlı olarak Search yanıtının her bir sayfasını istemek için gereken ağ gidiş dönüş süresini ortadan kaldırarak SearchStream, özellikle daha büyük raporlar için sayfalama yöntemine kıyasla daha iyi performans sunabilir.
Örnek
Bu örnekte, 100,000 satırdan oluşan bir rapor incelenmektedir. Aşağıdaki tabloda, iki yöntem arasındaki muhasebe farklılıkları açıklanmıştır.
| SearchStream | Ara | |
|---|---|---|
| Sayfa boyutu | Geçerli Değil | Sayfa başına 10.000 satır |
| API isteği sayısı | 1 istek | 10 istek |
| API yanıtı sayısı | 1 sürekli akış | 10 yanıt |
Performans faktörleri
Çoğu kullanım alanı için aşağıdaki nedenlerden dolayı Search yerine SearchStream kullanmanızı öneririz:
Tek sayfalık raporlar için (10.000 satırın altında): İki yöntem arasında önemli bir performans farkı yoktur.
Birden fazla sayfa içeren raporlar için: Birden fazla gidiş dönüşten kaçınıldığı ve disk önbelleğinden okuma veya yazma işleminin daha az etkili olduğu için
SearchStreamgenellikle daha hızlıdır.
Hız sınırları
Her iki yöntem için de günlük sınırlar, geliştirici jetonunuzun standart sınırlarına ve erişim düzeylerine uyar. Tek bir sorgu veya rapor, sonucun sayfaya bölünmüş veya akış halinde olup olmadığına bakılmaksızın tek bir işlem olarak sayılır.