GoogleAdsService Kullanarak Akış Rapor Akışı

Google Ads API varlıklarını ve raporlama verilerini almak için aşağıdaki yöntemlerden birini kullanabilirsiniz:

İki yöntem arasındaki temel farklar şunlardır:

GoogleAdsService.SearchStream GoogleAdsService.Search
Üretim kodu için uygun Yes Yes
Hizmet GoogleAdsService GoogleAdsService
Senaryo Nesneleri ve raporları getirme Nesneleri ve raporları getirme
Yanıt GoogleAdsRow nesne akışı GoogleAdsRow nesnenin 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

Search, raporun tamamını indirmek için birden fazla sayfaya ayrılmış istek gönderebilir. SearchStream ise 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, sonucun tamamı veri arabelleğinde önbelleğe alınırken hemen indirilmeye başlar. Kodunuz, tüm akışın tamamlanmasını beklemek zorunda kalmadan arabelleğe alınan verileri okumaya başlayabilir.

Uygulamanıza bağlı olarak Search bir yanıtın her bir sayfasını istemek için gereken gidiş-dönüş ağ süresini ortadan kaldırarak SearchStream özellikle büyük raporlarda, sayfalandırmaya kıyasla daha iyi performans sağlayabilir.

Örnek

Örneğin 100,000 satırdan oluşan bir raporu ele alalım. Aşağıdaki tabloda, iki yöntem arasındaki muhasebe farkları gösterilmiştir.

SearchStream Arama
Sayfa boyutu Geçerli değil Sayfa başına 10.000 satır
API isteği 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, aşağıdaki nedenlerden dolayı Search yerine SearchStream kullanmanızı öneririz:

  • Tek sayfalık raporlar (10.000'in altında satır) için: İki yöntem arasında önemli bir performans farkı yoktur.

  • Birden fazla sayfa raporu için: SearchStream, birden fazla döngüden kaçınıldığı ve disk önbelleğinden okuma veya yazma işlemleri daha az önemli bir faktör olduğundan genellikle 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 sayfalandırılmasına veya akışa alınmasından bağımsız olarak tek bir işlem olarak sayılır.