逐頁瀏覽資源清單

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