逐頁瀏覽資源清單

您可以控制伺服器在 設定 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