فللتعامل مع مجموعات النتائج التي تحتوي على عدد كبير من الصفوف، يستخدم التاجر
تتوافق لغة طلب البحث المركزية مع التقسيم على صفحات. تتوفر معلمتان
التحكم في التقسيم على صفحات في طلب 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"
}