صفحه‌بندی نتایج پُرسمان

زبان پُرسمان Merchant Center فیلدهای زیر را برای صفحه‌بندی ارائه می‌دهد:

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

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

برای مثال، اگر پُرسمان زیر را در حسابی که ۱۰۰٬۰۰۰ مقدار offer_id دارد انجام دهید و pageSize روی ۲۰۰ تنظیم شده باشد، نتیجه فقط شامل ۲۰۰ شیء ReportRow در اولین پاسخ به‌همراه یک nextPageToken است:

SELECT offer_id, impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-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"
}

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

نکته کلیدی: nextPageToken در پاسخی که حاوی آخرین دسته ردیف‌ها است، پر نمی‌شود.