Menelusuri hasil

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.