Untuk menangani set hasil yang berisi baris dalam jumlah besar, Bahasa Kueri Merchant Center mendukung penomoran halaman. Tersedia dua parameter 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 baris maksimum 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
disediakan, semua parameter lain dalam panggilan harus sesuai 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 lagi permintaan 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"
}