نمای کلی

صفحه بندی

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 نشان داده شده در واکشی صفحه اول باشد.