Paginate query results

توفّر لغة طلب البحث في Merchant Center الحقول التالية للتقسيم على صفحات:

  • pageSize: الحد الأقصى لعدد الصفوف المطلوب استردادها في طلب واحد. يتم ضبط الحد الأقصى لحجم الصفحة تلقائيًا على 1000 صف.
  • pageToken: الرمز المميّز للصفحة المطلوب عرضها. إذا لم يتم تحديدها، سيتم عرض الصفحة الأولى.
  • nextPageToken: قيمة pageToken للحصول على الصفحة التالية من طلب accounts.reports.search.

عند تقديم pageToken، يجب أن تتطابق جميع المَعلمات الأخرى في الطلب مع الطلب السابق لتجنُّب حدوث سلوك غير متوقّع.

على سبيل المثال، إذا أجريت طلب البحث التالي على حساب يتضمّن 100,000 قيمة offer_id، وتم ضبط pageSize على 200، ستتضمّن النتيجة 200 عنصر 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"
}

لاسترداد الـ 200 صف التالية، أرسِل الطلب مرة أخرى مع حجم الصفحة نفسه، ولكن عدِّل pageToken الطلب إلى nextPageToken من الاستجابة السابقة.