صفحه بندی
LSA از صفحهبندی برای پاسخگویی به درخواستهای یک عکس فوری بزرگ در چند واکشی صفحه (کشش) پشتیبانی میکند. Google یک نقطه پایانی شریک معین را با یک پارامتر حداکثر maxresults
تا حداکثر مقدار سرویس ارائهدهندگان را که در پاسخ JSON برگردانده میشوند، محدود کند. شرکا یک نشانه صفحهبندی را در قسمت metadata.pagination.nextTokenParam
در پاسخ JSON پر میکنند. مقدار این توکن مخصوص شریک است و برای ساخت URL صفحه بعدی استفاده می شود. قسمت nextTokenParam
نباید برای آخرین صفحه پر شود. لطفاً توجه داشته باشید که شی metadata.pagination
باید همیشه پر شود (همانطور که در طرح مورد نیاز است)، حتی اگر صفحه آخر دارای فیلد nextTokenParam
. علاوه بر این، totalCount
تعداد کل ارائهدهندگان خدمات (یا reviewItems
در مورد فید نظرات) را در همه صفحات نشان میدهد.
برای مثال، اگر یک شریک 200 ارائه دهنده در عکس فوری کامل داشته باشد. وقتی Google انتقال فیدها را با نشانی اینترنتی http://www.partners.com/feeds/{version}/profile&maxresults=100
آغاز میکند، صفحه اول باید 100 ارائهدهنده شریک اول را با متاداده زیر metaData
:
"metaData": {
"feedCategory":"SNAPSHOT",
"feedTimestampMicros":1532930955190163,
"apiVersion": "v1",
"pagination": {
"nextTokenParam": "yre7yiesar"
},
"totalCount":200
}
"serviceProviders": {....} // Contains 100 service provider objects.
Google nextTokenParam: "yre7yiesar"
را تجزیه می کند و دومین انتقال را با آدرس اینترنتی آغاز می کند: http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100
صفحه دوم باید 100 ارائه دهنده آخر را برگرداند. با توجه به اینکه صفحه دوم نیز آخرین صفحه است، nextTokenParam
نخواهد شد (مثال metaData
زیر)، که نشان دهنده پایان صفحه بندی است.
"metaData": {
"feedCategory":"SNAPSHOT",
"feedTimestampMicros":1532930955190164,
"apiVersion": "v1",
"pagination": {},
"totalCount":200
}
"serviceProviders": {....}
توجه داشته باشید که پس از واکشی همه صفحات، تعداد کل اشیاء serviceProviders
(در تمام صفحات) باید برابر با totalCount
نشان داده شده در واکشی صفحه اول باشد.