Paginate query results

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

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

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

على سبيل المثال، إذا أجريت الطلب التالي على حساب يحتوي على 100,000 قيمة offerId، وتم ضبط pageSize على 200، تحتوي النتيجة على 200 ReportRow عنصر فقط في الاستجابة الأولى، بالإضافة إلى nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-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 في الاستجابة التي تتضمن آخر دفعة من الصفوف.