Google Ads API varlıklarını ve raporlama verilerini almak için şu yöntemlerden birini kullanabilirsiniz:
İki yöntem arasındaki önemli farkları aşağıda bulabilirsiniz:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Üretim koduna uygun | Yes | Yes |
| Hizmet | GoogleAdsService |
GoogleAdsService |
| Senaryo | Nesneleri ve raporları alma | Nesneleri ve raporları alma |
| Yanıt | GoogleAdsRow nesnenin akışı |
GoogleAdsRow nesnenin sayfaları |
| Yanıt 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ırlar | Erişim düzeylerine göre günlük sınırlar |
Arama Yayını ile Arama Ağı Karşılaştırması
Search, raporun tamamını indirmek için birden fazla sayfalara ayrılmış istek gönderebilir. Ancak SearchStream, tek bir istek gönderip raporun boyutundan bağımsız olarak Google Ads API ile kalıcı bağlantı başlatır.
SearchStream için veri paketleri hemen indirilmeye başlar ve sonucun tamamı veri arabelleğinde önbelleğe alınır. Kodunuz, tüm akışın bitmesini beklemek zorunda kalmadan arabelleğe alınan verileri okumaya başlayabilir.
SearchStream, uygulamanıza bağlı olarak bir Search yanıtının her bir sayfasını istemek için gereken gidiş dönüş ağ süresini ortadan kaldırarak özellikle büyük raporlar için sayfalara ayırma işleminde daha iyi performans sunabilir.
Örnek
Örneğin, 100,000 satırdan oluşan bir raporu ele alalım. Aşağıdaki tabloda, iki yöntem arasındaki muhasebe farklılıkları açıklanmaktadır.
| SearchStream | Arama | |
|---|---|---|
| Sayfa boyutu | Geçerli değil | Sayfa başına 10.000 satır |
| API isteklerinin sayısı | 1 istek | 10 istek |
| API yanıtlarının sayısı | 1 kesintisiz akış | 10 yanıt |
Performans faktörleri
Çoğu kullanım alanında şu nedenlerle Search yerine SearchStream kullanılmasını öneririz:
Tek sayfalık raporlar (10.000 satırın altında): İki yöntem arasında önemli performans farkları yoktur.
Birden fazla sayfa raporu için: Birden fazla gidiş gelişin önlenmesi ve disk önbelleğinden okuma veya yazmanın daha az önemli olduğu için
SearchStreamgenellikle daha hızlıdır.
Hız sınırları
Her iki yöntem için 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 veya akışa aktarılmasına bakılmaksızın tek bir işlem olarak sayılır.