Memberi nomor halaman pada hasil kueri

Untuk menangani kumpulan hasil yang berisi baris dalam jumlah besar, Center Query Language mendukung penomoran halaman. Dua parameter tersedia untuk mengontrol penomoran halaman dalam permintaan reports.search isi: page_size dan page_token, selain satu kolom output di respons isi: next_page_token.

Parameter page_size menentukan jumlah baris maksimum yang akan diambil dalam permintaan tunggal. Jika tidak ditentukan, ukuran akan otomatis disetel ke ukuran halaman maksimum sebanyak 1.000 baris.

Parameter page_token menentukan token halaman yang akan ditampilkan. Jika belum ditentukan, maka halaman pertama akan ditampilkan. Untuk mengambil halaman berikutnya, metode nilai yang diterima sebagai next_page_token dari panggilan reports.search sebelumnya harus disediakan sebagai page_token. Jika page_token disediakan, semua elemen lain parameter dalam panggilan harus sesuai dengan panggilan sebelumnya yang menampilkan page_token untuk menghindari perilaku yang tidak diharapkan.

Contoh:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

Untuk kueri ini, asumsikan akun berisi 100.000 offer_ids dan page_size ditetapkan ke 200. Kumpulan hasilnya kemudian akan berisi 200 ReportRow dalam respons pertama, beserta next_page_token.

Untuk mengambil 200 baris berikutnya, kirim permintaan lagi dengan ukuran halaman yang sama, tetapi perbarui page_token permintaan ke respons sebelumnya next_page_token.

Berikut adalah contoh isi respons (lima hasil pertama ditambah next_page_token):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}