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 verilmiştir:
| 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 akışı |
GoogleAdsRow nesnelerinin sayfaları |
| Yanıtın alanları | Yalnızca sorguda belirtilenler | Yalnızca sorguda belirtilenler |
| Günlük sınırlar | Erişim düzeylerine dayalı günlük sınırlar | Erişim düzeylerine dayalı günlük sınırlar |
SearchStream - Search
Search, raporun tamamını indirmek için birden fazla sayfalandırılmış 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ğinde önbelleğe alınır. Kodunuz, akışın tamamlanmasını beklemeden arabelleğe alınmış verileri okumaya başlayabilir.
Search yanıtının her bir sayfasını istemek için gereken gidiş-dönüş ağ süresini ortadan kaldırarak, uygulamanıza bağlı olarak SearchStream, özellikle daha büyük raporlar için sayfalama işlemine 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çıklanmaktadır.
| SearchStream | Ara | |
|---|---|---|
| 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 sürekli yayın | 10 yanıt |
Performans faktörleri
Çoğu kullanım alanında, aşağıdaki nedenlerden dolayı SearchStream yerine Search kullanmanızı öneririz:
Tek sayfalık raporlar (10.000 satırdan az) için: İki yöntem arasında önemli performans farkı yoktur.
Çok sayfalı raporlar için: Birden fazla gidiş dönüş önlendiği ve disk önbelleğinden okuma veya yazma 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 uygundur. Sonucun sayfalandırılmış veya yayınlanmış olmasından bağımsız olarak tek bir sorgu ya da rapor tek bir işlem olarak sayılır.