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

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