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

אתם יכולים לקבוע את המספר המקסימלי של מקורות שהשרת מחזיר בתגובה לבקשת רשימה על ידי הגדרת השדה 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