קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אפשר לקבוע את המספר המקסימלי של המשאבים שהשרת יחזיר בתגובה לבקשת רשימה על ידי הגדרת השדה 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
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-12-21 (שעון UTC)."],[[["Control the maximum number of resources returned in a list request by setting the `maxResults` field, with some collections having hard limits on retrievable entries."],["Detect incomplete results by checking for a non-empty `nextPageToken` field, which indicates the presence of additional pages."],["Retrieve the next page of results by performing the same request and appending a `pageToken` field with the `nextPageToken` value from the previous page."],["The server provides new `nextPageToken` values on subsequent pages until all results are retrieved, enabling complete data retrieval through pagination."]]],[]]
