Memberi nomor halaman pada hasil kueri

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

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

Parameter page_token menentukan token halaman yang akan ditampilkan. Jika tidak ditentukan, halaman pertama akan ditampilkan. Untuk mengambil halaman berikutnya, nilai yang diterima sebagai next_page_token dari panggilan reports.search sebelumnya harus diberikan sebagai page_token. Jika page_token diberikan, semua parameter lain dalam panggilan harus cocok dengan panggilan sebelumnya yang menampilkan page_token untuk menghindari perilaku yang tidak terduga.

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. Set hasil kemudian akan berisi 200 objek 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 next_page_token respons sebelumnya.

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"
}