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

אפשר להגדיר את השדה 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