Paginate query results

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

• pageSize: الحد الأقصى لعدد الصفوف المطلوب استردادها في طلب واحد. يتم ضبط القيمة التلقائية على الحد الأقصى لحجم الصفحة وهو 1000 صف.
• 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 في الردّ الذي يحتوي على الدفعة الأخيرة من الصفوف