在应用中对 Microsoft Graph 数据进行分页

如果 Microsoft Graph 请求返回太多信息,无法在一个页面中进行显示,那么可以使用分页将信息分成若干可管理的区块。

可以在 Microsoft Graph 响应中向后翻页和向前翻页。包含分页结果的响应会包含跳过令牌 (odata.nextLink),以便可以获取下一页结果。此跳过令牌可与 previous-page=true 查询自变量结合使用,从而向前翻页。

以下请求示例演示向后翻页:

https://graph.microsoft.com/v1.0/users?$top=5$skiptoken=X'4453707402.....0000'

包含之前响应中的 $skiptoken 参数,并允许你获取下一页结果。

以下请求示例演示向前翻页:

https://graph.microsoft.com/v1.0/users?$top=5$skiptoken=X'4453707.....00000'&previous-page=true

包含之前响应中的 $skiptoken 参数。与 &previous-page=true 参数结合使用时,将检索上一页结果。

以下为向后翻页和向前翻页的请求/响应步骤:

  1. 生成请求,以获取 15 个用户中的前 10 个用户的列表。响应中包含跳过令牌,以指明最终的 10 个用户页面。
  2. 若要获取最后 5 个用户,请生成另一个请求,其中包含之前响应返回的跳过令牌。
  3. 若要向前翻页,请使用第 1 步中返回的跳过令牌生成请求,并将参数 &previous-page=true 添加到请求中。
  4. 响应中包含前一页(前)10 个用户。在其他情况下,若有更多页面剩余,则会返回新的跳过令牌。这个新的跳过令牌可以与 &previous-page=true 一起添加到请求中,以便再次向前翻页。

以下限制适用于分页请求:

  • 默认页面大小是 100。页面大小上限是 999。
  • 角色查询不支持分页。这包括读取角色对象本身以及角色成员。
  • 链接搜索(如查询组成员)不支持分页。