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

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

חשוב לזכור שהפרמטר 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