Paginate query results

Bahasa Kueri Merchant Center menyediakan kolom berikut untuk penomoran halaman:

  • pageSize: Jumlah baris maksimum yang akan diambil dalam satu permintaan. Ukuran defaultnya adalah ukuran halaman maksimum 1.000 baris.
  • pageToken: Token halaman yang akan ditampilkan. Jika tidak ditentukan, halaman pertama akan ditampilkan.
  • nextPageToken: Nilai pageToken untuk mendapatkan halaman berikutnya dari panggilan accounts.reports.search.

Jika pageToken disediakan, semua parameter lain dalam panggilan harus cocok dengan panggilan sebelumnya untuk menghindari perilaku yang tidak diharapkan.

Misalnya, jika Anda membuat kueri berikut di akun yang memiliki 100.000 nilai offerId, dan pageSize ditetapkan ke 200, hasilnya hanya berisi 200 objek ReportRow dalam respons pertama, bersama dengan nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

Berikut ini contoh respons (lima hasil pertama dan nextPageToken):

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

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