Melaporkan streaming menggunakan GoogleAdsService

Untuk mengambil entity dan data pelaporan Google Ads API, gunakan salah satu metode berikut:

Berikut adalah perbedaan tingkat tinggi untuk kedua metode tersebut:

GoogleAdsService.SearchStream GoogleAdsService.Search
Cocok untuk kode produksi Ya Ya
Layanan GoogleAdsService GoogleAdsService
Skenario Mengambil objek dan laporan Mengambil objek dan laporan
Respons Streaming objek GoogleAdsRow Halaman objek GoogleAdsRow
Kolom respons Hanya yang ditentukan dalam kueri Hanya yang ditentukan dalam kueri
Batas harian Batas harian berdasarkan tingkat akses Batas harian berdasarkan tingkat akses

Meskipun Search dapat mengirim beberapa permintaan yang diberi nomor halaman untuk mendownload seluruh laporan, SearchStream mengirim satu permintaan dan memulai koneksi persisten dengan Google Ads API, terlepas dari ukuran laporan.

Untuk SearchStream, paket data akan langsung mulai didownload dengan seluruh hasil di-cache dalam buffering data. Kode Anda dapat mulai membaca data yang dibuffer tanpa harus menunggu seluruh streaming selesai.

Dengan menghilangkan waktu jaringan bolak-balik yang diperlukan untuk meminta setiap halaman respons Search, bergantung pada aplikasi Anda, SearchStream dapat menawarkan performa yang lebih baik daripada paging, terutama untuk laporan yang lebih besar.

Contoh

Contoh ini melihat laporan yang terdiri dari 100,000 baris. Tabel berikut memerinci perbedaan akuntansi antara kedua metode tersebut.

SearchStream Telusuri
Ukuran halaman Tidak Berlaku 10.000 baris per halaman
Jumlah permintaan API 1 permintaan 10 permintaan
Jumlah respons API 1 streaming berkelanjutan 10 respons

Faktor performa

Untuk sebagian besar kasus penggunaan, sebaiknya gunakan SearchStream daripada Search karena alasan berikut:

  • Untuk laporan satu halaman (di bawah 10.000 baris): Tidak ada perbedaan performa yang signifikan antara kedua metode tersebut.

  • Untuk laporan beberapa halaman: SearchStream biasanya lebih cepat karena beberapa perjalanan bolak-balik dihindari, dan membaca atau menulis dari cache disk tidak terlalu berpengaruh.

Batas kapasitas

Batas harian untuk kedua metode tersebut mematuhi batas standar dan tingkat akses token developer Anda. Satu kueri atau laporan dihitung sebagai satu operasi, terlepas dari hasil yang di-paging atau di-streaming.