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