Untuk mengambil data pelaporan dan entity Google Ads API, Anda dapat menggunakan salah satu metode berikut:
Berikut adalah perbedaan garis besar 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 | Aliran 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 |
SearchStream versus Penelusuran
Meskipun Search dapat mengirim beberapa permintaan dengan nomor halaman untuk mendownload seluruh laporan, SearchStream mengirim satu permintaan dan memulai koneksi persisten dengan Google Ads API terlepas dari ukuran laporannya.
Untuk SearchStream, paket data akan segera mulai didownload dengan seluruh hasil di-cache di buffer data. Kode Anda dapat mulai membaca data yang di-buffer 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 peningkatan performa melalui paging, terutama untuk laporan yang lebih besar.
Contoh
Misalnya, laporan yang terdiri dari 100,000 baris. Tabel berikut menguraikan 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 jawaban |
Faktor performa
Untuk sebagian besar kasus penggunaan, sebaiknya gunakan SearchStream daripada Search untuk alasan berikut:
Untuk laporan satu halaman (kurang dari 10.000 baris): Tidak ada perbedaan performa yang signifikan di antara kedua metode tersebut.
Untuk laporan beberapa halaman:
SearchStreambiasanya lebih cepat karena beberapa roundtrip dihindari dan membaca atau menulis dari cache disk bukan faktor yang penting.
Batas kapasitas
Batas harian untuk kedua metode mematuhi batas standar dan tingkat akses token developer Anda. Kueri atau laporan tunggal dihitung sebagai satu operasi, terlepas dari hasilnya yang di-page atau di-streaming.