إنّ لغة طلب البحث في 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
من
الاستجابة السابقة.