浏览资源列表

通过设置 maxResults 字段,您可以控制服务器在响应列表请求时返回的最大资源数。此外,对于某些集合(例如事件),服务器对检索到的条目数量有硬性限制。如果事件总数超过此上限,服务器将返回一个页面结果。

请注意,maxResults 无法保证一个网页上的结果数量。结果中的非空 nextPageToken 字段可以检测到不完整的结果。如需检索下一页,请执行与之前完全相同的请求,并在上一页中附加一个值为 nextPageTokenpageToken 字段。系统将在后续网页上提供新的 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