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

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