דפדוף ברשימת משאבים

אתם יכולים לקבוע את המספר המקסימלי של משאבים שהשרת מחזיר בתגובה לבקשת רשימה על ידי הגדרת השדה maxResults. בנוסף, עבור אוספים מסוימים (כמו Events) יש מגבלה קשיחה על מספר הרשומות שאוחזרו, שהשרת לעולם לא יחרוג ממנה. אם המספר הכולל של האירועים גדול מהמספר המקסימלי הזה, השרת מחזיר דף אחד של תוצאות.

חשוב לזכור שהערך maxResults לא מבטיח את מספר התוצאות בדף אחד. אפשר לזהות תוצאות חלקיות לפי השדה nextPageToken שלא ריק בתוצאה. כדי לאחזר את הדף הבא, צריך לשלוח את אותה בקשה בדיוק כמו קודם, ולהוסיף שדה pageToken עם הערך של nextPageToken מהדף הקודם. אסימון חדש nextPageToken מסופק בדפים הבאים עד לאחזור כל התוצאות.

לדוגמה, הנה שאילתה ואחריה השאילתה לאחזור הדף הבא של תוצאות ברשימה עם מספור עמודים:

GET /calendars/primary/events?maxResults=10&singleEvents=true

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

השאילתה הבאה לוקחת את הערך מ-nextPageToken ושולחת אותו כערך של pageToken:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA