GoogleAdsService.Search
mendukung
paging dengan menentukan
page_size
dalam permintaan Anda.
Tindakan ini akan membagi kumpulan hasil kueri menjadi beberapa respons, yang masing-masing
berisi hingga page_size
objek. Jika
page_size
tidak ditentukan,
nilai maksimum akan otomatis ditetapkan ke 10.000 baris.
Sebagai contoh, untuk 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 dan
page_size
ditetapkan ke 1,000
,
kumpulan hasilnya akan berisi 1.000 objek GoogleAdsRow
dalam respons pertama, beserta
next_page_token
.
Untuk mengambil seribu baris berikutnya, kirim lagi permintaan dengan ukuran
halaman yang sama, tetapi perbarui page_token
permintaan ke
next_page_token
respons. Nilai
page_size
dalam
permintaan berikutnya dapat berbeda setiap saat. Perhatikan bahwa
next_page_token
tidak
diisi dalam respons yang berisi batch baris terakhir.
Library klien kami menangani paging secara otomatis. Anda hanya perlu mengulangi melalui baris-baris respons. Jika semua baris di halaman saat ini telah ditampilkan, library klien akan mengambil halaman baru yang berisi baris secara otomatis 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 meng-cache seluruh set data, sehingga permintaan berikutnya lebih cepat daripada permintaan awal. Bergantung pada kasus penggunaan, Anda dapat menetapkan page_size
ke nilai apa pun antara 1 dan 10.000. Secara umum, untuk performa keseluruhan yang lebih cepat, gunakan
page_size
yang lebih besar untuk perjalanan pulang pergi
yang lebih sedikit.
Kueri Anda harus tetap sama dalam permintaan berikutnya untuk memanfaatkan data yang di-cache. Permintaan tersebut tidak akan berkontribusi terhadap kuota Anda, terutama untuk akses dasar. Jika kueri berbeda dan dikirim bersama dengan token halaman yang sama, error akan ditampilkan.