Paginate query results

زبان جستجوی Merchant Center فیلدهای زیر را برای صفحه بندی فراهم می کند:

• pageSize : حداکثر تعداد ردیف هایی که در یک درخواست بازیابی می شوند. حداکثر اندازه صفحه 1000 ردیف پیش فرض است.
• pageToken : نشانه صفحه برای بازگشت. اگر مشخص نشده باشد، صفحه اول برگردانده می شود.
• nextPageToken : مقدار pageToken برای دریافت صفحه بعدی از یک تماس accounts.reports.search .

هنگامی که یک pageToken ارائه می شود، تمام پارامترهای دیگر در تماس باید با تماس قبلی مطابقت داشته باشند تا از رفتار غیرمنتظره جلوگیری شود.

برای مثال، اگر در حسابی که دارای 100000 مقدار offerId است، پرس و جو زیر را انجام دهید و pageSize روی 200 تنظیم شده باشد، نتیجه شامل تنها 200 شی ReportRow در اولین پاسخ به همراه nextPageToken است:

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

در اینجا نمونه پاسخ (پنج نتیجه اول و 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"
}

برای بازیابی 200 ردیف بعدی، درخواست را دوباره با همان اندازه صفحه ارسال کنید، اما pageToken درخواست را به nextPageToken از پاسخ قبلی به روز کنید.

نکته کلیدی: nextPageToken در پاسخی که حاوی آخرین دسته سطرها است پر نشده است.