סקירה כללית

חלוקה לדפים

ה-LSA תומך בחלוקה לעמודים כדי להתאים לבקשות של תמונת מצב גדולה בכמה אחזורים (משיכות) של דפים. ‫Google תמשוך נקודת קצה של שותף עם פרמטר maxresults כדי להגביל את הכמות המקסימלית של ספקי שירות שיוחזרו בתשובת ה-JSON. שותפים יאכלסו אסימון של חלוקה לעמודים בשדה metadata.pagination.nextTokenParam בתגובת ה-JSON. הערך של האסימון הזה הוא ספציפי לשותף ומשמש לבניית כתובת ה-URL של הדף הבא. nextTokenParam אסור לאכלס את השדה בדף האחרון. חשוב לשים לב שאובייקט metadata.pagination תמיד צריך להיות מאוכלס (כי הוא נדרש בסכימה), גם אם בדף האחרון לא יהיה שדה nextTokenParam. בנוסף, totalCount מציין את המספר הכולל של ספקי שירותים (או reviewItems במקרה של פיד ביקורות) בכל הדפים.

לדוגמה, אם לשותף יש 200 ספקים בתמונת המצב המלאה. כש-Google מתחילה את העברת הפידים עם כתובת ה-URL‏ 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" ותתחיל את ההעברה השנייה עם כתובת ה-URL: 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 שמופיע באחזור הדף הראשון.