Anda dapat melihat hasil yang diambil dengan GoogleAdsService.Search
alih-alih mendownload seluruh set hasil sekaligus. Untuk ringkasan pelaporan dengan Google Ads API, lihat Panduan pelaporan.
Hasil ditampilkan dalam halaman hingga 10.000 baris. Jika page_size dalam
permintaan tidak disetel, nilai defaultnya adalah 10.000. Jika page_size disetel ke nilai yang lebih besar dari 10.000, nilai 10.000 akan tetap digunakan.
Sebagai contoh, perhatikan kueri berikut:
SELECT
ad_group.id,
ad_group_criterion.type,
ad_group_criterion.criterion_id,
ad_group_criterion.keyword.text,
ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD
Jika akun Anda berisi 50.000 kata kunci, set hasil akan berisi 10.000
GoogleAdsRow objek dalam respons pertama, beserta
next_page_token.
Untuk mengambil 10.000 baris berikutnya, kirim permintaan lagi, tetapi perbarui
page_token permintaan ke next_page_token respons. Perhatikan bahwa
next_page_token tidak diisi dalam respons yang berisi
batch baris terakhir.
Library klien kami menangani penomoran halaman secara otomatis. Anda hanya perlu melakukan iterasi melalui baris respons. Setelah semua baris di halaman saat ini ditampilkan, library klien akan otomatis mengambil halaman baris baru atas nama Anda hingga seluruh set data diambil. Jika menggunakan REST, bukan gRPC, Anda harus membuat permintaan secara eksplisit untuk setiap halaman baru.
Google Ads API secara internal menyimpan seluruh set data dalam cache, sehingga permintaan berikutnya lebih cepat daripada permintaan awal.
Kueri Anda harus tetap sama persis dalam permintaan berikutnya untuk memanfaatkan data yang di-cache. Permintaan tidak akan memengaruhi kuota Anda, terutama untuk tingkat Akses Explorer dan tingkat Akses Dasar. Jika kueri berbeda dan dikirim bersama dengan token halaman yang sama, error akan ditampilkan.