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

فللتعامل مع مجموعات النتائج التي تحتوي على عدد كبير من الصفوف، يستخدم التاجر تتوافق لغة طلب البحث المركزية مع التقسيم على صفحات. تتوفر معلمتان التحكم في التقسيم على صفحات في طلب reports.search النص الأساسي: page_size وpage_token، بالإضافة إلى حقل إخراج واحد في الرد النص الأساسي: next_page_token

تحدّد المعلَمة page_size الحد الأقصى لعدد الصفوف المطلوب استردادها في في طلب واحد. إذا لم يتم تحديده، يتم ضبطه تلقائيًا على أقصى حجم للصفحة. من 1000 صف.

تحدّد المَعلمة page_token الرمز المميّز للصفحة المطلوب عرضها. في حال حذف غير محدد، يتم عرض الصفحة الأولى. لاسترداد صفحة تالية، تم تلقّي القيمة على أنّها next_page_token من مكالمة reports.search السابقة. يجب تقديمه على أنّه page_token. عند توفير page_token، يتم تضمين جميع في الاستدعاء، يجب أن تتطابق مع الاستدعاء السابق الذي عرض page_token لتجنُّب حدوث سلوك غير متوقَّع.

مثال:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

بالنسبة إلى طلب البحث هذا، لنفترض أنّ الحساب يحتوي على 100,000 offer_ids تَمّْ ضَبْطِ page_size عَلَى 200. ستحتوي مجموعة النتائج بعد ذلك على 200 ReportRow الكائنات في الاستجابة الأولى، بالإضافة إلى next_page_token.

لاسترداد الصفوف الـ 200 التالية، أرسل الطلب مرة أخرى بنفس حجم الصفحة، ولكن عدِّل page_token للطلب إلى الردّ السابق. next_page_token

فيما يلي مثال لنص الاستجابة (النتائج الخمس الأولى بالإضافة إلى next_page_token):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}