Paging Melalui Hasil

GoogleAdsService.Search mendukung paging dalam ukuran halaman tetap sebesar 10.000 baris. Set hasil kueri dibagi menjadi beberapa respons, yang masing-masing berisi 10.000 objek.

Misalnya, 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, kumpulan 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. 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.

Google Ads API menyimpan seluruh set data dalam cache secara internal, sehingga permintaan berikutnya lebih cepat daripada permintaan awal.

Kueri Anda harus tetap sama persis dalam permintaan berikutnya untuk memanfaatkan data yang di-cache; permintaan tidak akan berkontribusi pada kuota Anda, terutama untuk akses dasar. Jika kueri berbeda dan dikirim bersama dengan token halaman yang sama, error akan ditampilkan.