Memberi nomor halaman pada hasil kueri

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"
}
Sebelumnya
Segmentation