浏览资源列表

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