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