Paginate query results

Bahasa Kueri Merchant Center menyediakan kolom berikut untuk penomoran halaman:

  • pageSize: Jumlah maksimum baris yang akan diambil dalam satu permintaan. Secara default, ukuran halaman maksimum adalah 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 diberikan, semua parameter lain dalam panggilan harus cocok dengan panggilan sebelumnya untuk menghindari perilaku yang tidak terduga.

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

SELECT offer_id, impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-31'

Berikut adalah 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 permintaan lagi dengan ukuran halaman yang sama, tetapi perbarui pageToken permintaan ke nextPageToken dari respons sebelumnya.