浏览资源列表

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

请注意,maxResults 并不保证一页上的结果数量。 如果响应中存在非空 nextPageToken 字段,则表示结果不完整。 如需检索下一页,请重复上一个请求,并附加一个 pageToken 参数,其值为上一页中的 nextPageToken。后续每个页面都会提供一个新的 nextPageToken,直到响应包含所有结果为止。

例如,以下查询请求第一页:

GET /calendars/primary/events?maxResults=10&singleEvents=true

响应包含 nextPageToken

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

后续查询会从 nextPageToken 中获取值,并将其作为 pageToken 的值提交:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA