逐頁瀏覽資源清單

您可以設定 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