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