逐頁瀏覽資源清單

您可以設定 maxResults 欄位，藉此控制伺服器在清單要求回應中傳回的資源數量上限。此外，某些集合 (例如事件) 對擷取的項目數量設有硬性限制，伺服器永遠不會超過這些數量。如果事件總數超過這個上限，伺服器會傳回一頁的結果。

提醒您，maxResults 無法保證單一網頁可獲得的結果數量。 系統可能會使用結果中的非空白 nextPageToken 欄位偵測不完整的結果。如要擷取下一頁，請執行與先前完全相同的要求，並附加包含前一頁 nextPageToken 值的 pageToken 欄位。後續頁面中將會提供新的 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