Paging Melalui Hasil

Bahasa Kueri Google Ads mendukung paging dengan menentukan page_size dalam permintaan Anda. Tindakan ini akan menguraikan kumpulan hasil kueri menjadi beberapa respons yang masing-masing berisi hingga objek page_size. Jika page_size tidak ditentukan, ukuran halaman akan otomatis ditetapkan ke ukuran halaman maksimum 10.000 baris.

Misalnya, dengan 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 dan page_size ditetapkan ke 1,000, kumpulan hasilnya akan berisi 1.000 objek GoogleAdsRow dalam respons pertama, bersama dengan next_page_token. Untuk mengambil seribu baris berikutnya, cukup kirim permintaan lagi dengan ukuran halaman yang sama, tetapi perbarui page_token permintaan ke next_page_token respons. Nilai page_size dalam permintaan berikutnya dapat berbeda setiap saat.

Library klien kita menangani paging secara otomatis. Anda hanya perlu mengulangi baris-baris respons. Setelah semua baris di halaman saat ini ditampilkan, library klien akan mengambil halaman baris baru secara otomatis untuk Anda hingga seluruh set data diambil. Jika menggunakan REST, bukan gRPC, Anda harus secara eksplisit membuat permintaan untuk setiap halaman baru.

Google Ads API menyimpan seluruh set data dalam cache secara internal, sehingga permintaan berikutnya lebih cepat daripada permintaan pertama. Bergantung pada kasus penggunaan, Anda dapat menetapkan page_size ke nilai apa pun antara 1 dan 10.000. Secara umum, untuk performa keseluruhan yang lebih cepat, Anda harus menggunakan page_size yang lebih besar karena perjalanan dua arah yang lebih sedikit dalam respons Anda.

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