Paginate query results

Ngôn ngữ truy vấn Merchant Center cung cấp các trường sau đây để phân trang:

  • pageSize: Số hàng tối đa cần truy xuất trong một yêu cầu. Mặc định kích thước trang tối đa là 1.000 hàng.
  • pageToken: Mã thông báo của trang sẽ trả về. Nếu không chỉ định, hệ thống sẽ trả về trang đầu tiên.
  • nextPageToken: Giá trị pageToken để nhận trang tiếp theo từ lệnh gọi accounts.reports.search.

Khi pageToken được cung cấp, mọi tham số khác trong lệnh gọi phải khớp với lệnh gọi trước đó để tránh hành vi ngoài dự kiến.

Ví dụ: nếu bạn thực hiện truy vấn sau trên một tài khoản có 100.000 giá trị offerId và pageSize được đặt là 200, thì kết quả chỉ chứa 200 đối tượng ReportRow trong phản hồi đầu tiên, cùng với nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

Dưới đây là phản hồi mẫu (năm kết quả đầu tiên và 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"
}

Để truy xuất 200 hàng tiếp theo, hãy gửi lại yêu cầu với cùng kích thước trang, nhưng cập nhật pageToken của yêu cầu thành nextPageToken từ phản hồi trước đó.