Untuk mengambil entity Google Ads API dan data pelaporan, 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 level akses | Batas harian berdasarkan level akses |
SearchStream versus Search
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 segera didownload dengan seluruh hasil yang di-cache dalam buffer data. Kode Anda dapat mulai membaca data yang di-buffer tanpa harus menunggu seluruh streaming selesai.
Dengan menghilangkan waktu jaringan pulang pergi yang diperlukan untuk meminta setiap halaman respons Search, bergantung pada aplikasi Anda, SearchStream dapat menawarkan performa yang lebih baik daripada penomoran halaman, terutama untuk laporan yang lebih besar.
Contoh
Contoh ini melihat laporan yang terdiri dari 100,000 baris. Tabel berikut menguraikan perbedaan akuntansi antara kedua metode tersebut.
| SearchStream | Search | |
|---|---|---|
| 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 (kurang dari 10.000 baris): Tidak ada perbedaan performa yang signifikan antara kedua metode tersebut.
Untuk laporan beberapa halaman:
SearchStreambiasanya lebih cepat karena beberapa perjalanan pulang pergi dihindari, dan membaca atau menulis dari cache disk menjadi faktor yang lebih kecil.
Batas kapasitas
Batas harian untuk kedua metode tersebut mematuhi batas standar dan akses level token developer Anda. Satu kueri atau laporan dihitung sebagai satu operasi, terlepas dari hasil yang diberi nomor halaman atau di-streaming.