您可以通过设置 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