تقسيم نتائج طلب البحث على صفحات

توفّر لغة طلب البحث في 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 من الاستجابة السابقة.