Paging Melalui Hasil

GoogleAdsService.Search didukung {i>paging<i} dalam ukuran halaman tetap 10.000 baris. Kumpulan hasil kueri dibagi menjadi beberapa respons, masing-masing berisi 10.000 objek.

Sebagai contoh, 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, bersama dengan next_page_token.

Untuk mengambil 10.000 baris berikutnya, kirim permintaan lagi, tetapi perbarui page_token permintaan ke respons next_page_token. Perhatikan bahwa next_page_token tidak diisi dalam respons yang berisi batch baris terakhir.

Library klien kami menangani paging secara otomatis. Anda hanya perlu mengulangi melalui baris-baris respons. Ketika semua baris di halaman saat ini memiliki dikembalikan, pustaka klien mengambil laman baris baru secara otomatis pada nama Anda sampai seluruh {i>dataset<i} diambil. Jika menggunakan REST gRPC, Anda harus secara eksplisit membuat permintaan untuk setiap halaman baru.

Google Ads API menyimpan seluruh set data ke dalam cache secara internal, sehingga permintaan berikutnya lebih cepat dari yang sebelumnya.

Kueri Anda harus tetap sama persis dalam permintaan berikutnya untuk memanfaatkan data yang di-cache; permintaan tersebut tidak akan mengurangi kuota Anda, khususnya untuk akses dasar. Jika berbeda dan dikirim bersama dengan token halaman yang sama, sehingga error akan muncul.