Memberi nomor halaman pada hasil kueri

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

Parameter page_size menentukan jumlah maksimum baris yang akan diambil dalam satu permintaan. Jika tidak ditentukan, batas otomatis akan 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 lainnya 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. Kumpulan hasilnya kemudian akan berisi 200 objek ReportRow dalam respons pertama, bersama dengan 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"
}
Sebelumnya
Segmentasi