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

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

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

לדוגמה, השאילתה הבאה מבקשת את הדף הראשון:

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

התשובה מכילה את השדה nextPageToken:

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

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

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