Menelusuri hasil

Anda dapat melihat hasil yang diambil dengan GoogleAdsService.Search alih-alih mendownload seluruh set 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 akan 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, set hasil akan berisi 10.000 objek GoogleAdsRow 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:

{
  "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 kumpulan 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.

Penyimpanan ke cache dan masa berlaku token halaman

Google Ads API secara internal meng-cache set data sehingga permintaan halaman berikutnya lebih cepat daripada permintaan awal. Perhatikan bahwa nilai next_page_token memiliki waktu aktif (TTL) terbatas dan akan habis masa berlakunya jika tidak digunakan dalam waktu singkat (sekitar dua jam). Jika masa berlaku token halaman habis, 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 yang dipaginasi 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.