逐頁瀏覽資源清單

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