Anda dapat melihat halaman demi halaman hasil yang diambil dengan
GoogleAdsService.Search, bukan mendownload seluruh kumpulan hasil
sekaligus. Untuk ringkasan pelaporan dengan Google Ads API, lihat
Ringkasan pelaporan.
Search menampilkan halaman tetap hingga 10.000 baris. Menetapkan page_size di
SearchGoogleAdsRequest tidak digunakan lagi dan menampilkan
error RequestError.PAGE_SIZE_NOT_SUPPORTED.
Contoh kueri dan penomoran halaman
Pertimbangkan 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, kumpulan hasil akan berisi 10.000 objek GoogleAdsRow dalam respons pertama, bersama dengan next_page_token.
Untuk mengambil 10.000 baris berikutnya, kirim permintaan lagi, tetapi perbarui
page_token permintaan ke next_page_token respons:
{
"query": "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",
"pageToken": "CN3q9...example_token..."
}
Perhatikan bahwa next_page_token tidak diisi dalam respons yang
berisi batch baris terakhir.
Library klien kami menangani paging 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 secara eksplisit membuat permintaan untuk setiap halaman baru.
Caching dan masa berlaku token halaman
Google Ads API meng-cache set data secara internal sehingga permintaan halaman berikutnya lebih cepat daripada permintaan awal. Perhatikan bahwa nilai next_page_token memiliki
time to live (TTL) terbatas dan akan berakhir jika tidak digunakan dalam waktu singkat (sekitar
dua jam). Jika masa berlaku token halaman berakhir, API akan menampilkan error dan Anda harus memulai kueri baru.
Kueri Anda harus tetap sama dalam permintaan berikutnya untuk memanfaatkan data yang di-cache. Permintaan halaman berikutnya tidak dihitung sebagai operasi tambahan untuk kuota operasi harian Anda untuk akses Explorer dan akses Dasar. Jika kueri berbeda dan dikirim bersama token halaman yang sama, error akan ditampilkan.