您可以通过设置 maxResults 字段来控制服务器在对列表请求的响应中返回的资源数量上限。此外,对于某些集合(例如 Events),服务器检索的条目数量存在硬性限制,服务器绝不会超出此限制。如果事件总数超过此上限,服务器会返回一页结果。
请注意,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