您可以控制服务器在
通过设置 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