Anda dapat menelusuri halaman hasil yang diambil dengan
GoogleAdsService.Search, bukan mendownload seluruh kumpulan hasil
sekaligus. Untuk mengetahui 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
RequestError.PAGE_SIZE_NOT_SUPPORTED error.
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
GoogleAdsRow objek dalam respons pertama, beserta
next_page_token.
Untuk mengambil 10.000 baris berikutnya, kirim permintaan lagi, tetapi perbarui
permintaan page_token ke respons next_page_token:
{
"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 penomoran halaman secara otomatis. Anda hanya perlu melakukan iterasi melalui baris respons. Setelah semua baris di halaman saat ini ditampilkan, library klien akan mengambil halaman baris baru 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.
Caching dan masa berlaku token halaman
Google Ads API secara internal menyimpan set data dalam cache sehingga permintaan halaman berikutnya lebih cepat daripada permintaan awal. Perhatikan bahwa nilai next_page_token memiliki waktu aktif (TTL) terbatas dan akan berakhir jika tidak digunakan dalam waktu singkat (sekitar dua jam). Jika token halaman berakhir masa berlakunya, 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 terhadap kuota operasi harian Anda untuk akses Explorer dan akses Dasar. Jika kueri berbeda dan dikirim bersama dengan token halaman yang sama, error akan ditampilkan.