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 là kích thước trang tối đa là 1.000 hàng.
  • pageToken: Mã thông báo của trang cần trả về. Nếu không chỉ định, trang đầu tiên sẽ được trả về.
  • nextPageToken: Giá trị pageToken để lấy trang tiếp theo từ lệnh gọi accounts.reports.search.

Khi bạn cung cấp pageToken, tất cả các 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 không mong muố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ị offer_id và pageSize được đặt thành 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 offer_id, impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-31'

Dưới đây là phản hồi mẫu (5 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 đó.