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 من الاستجابة السابقة.

ملاحظة مهمة: لا يتمّ تعبئة nextPageToken في الاستجابة التي تحتوي على الحزمة الأخيرة من الصفوف.