Paginate query results

Kueri Merchant Center Bahasa memberikan hal berikut untuk penomoran halaman:

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

Saat pageToken diberikan, 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 offerId, dan pageSize disetel 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 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.