Paginate query results

Truy vấn trong Merchant Center Ngôn ngữ cung cấp những nội dung sau trường phân trang:

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

Khi cung cấp pageToken, tất cả các tham số khác trong lệnh gọi phải khớp với cuộc 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 tài khoản có 100.000 Các giá trị offerId và pageSize được đặt thành 200, kết quả chỉ chứa 200 Các đố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'

Mời bạn xem 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 hãy cập nhật pageToken của yêu cầu thành nextPageToken từ phản hồi trước đó.