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 |
SearchStream ve Arama
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.