Microsoft Graph API - 用户和组的每个增量查询的页面大小是多少？

Question

每个增量查询的页面大小是多少？

https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_users https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_groups

我的理解是 $top 不适用于用户和组的增量查询。所以我们无法设置自定义页面大小。

Answer 1

TL;DR：对于增量查询，页面大小不固定/保证。有

Prefer: odata.maxpagesize=X

参数，但它并不适用于所有查询。

---

如果您尝试使用以下命令在 Graph Explorer 中重现这种情况：

https://graph.microsoft.com/v1.0/me/calendarView/delta?startDateTime=2010-01-01 00:00:00&endDateTime=2020-01-01 00:00:00&$top=5

它会给你以下错误：

“CalendarView”资源的更改跟踪不支持“$top”参数，因为无法保证页面大小。使用 Prefer: odata.maxpagesize= 标题来表达页面大小首选项。

如本错误中所述，无法保证页面大小。但是，通过添加额外的标头

Prefer: odata.maxpagesize=10

您将能够看到只返回了 10 个结果。

备注 - 某些资源不支持此参数（也适用于您询问的资源 - 用户和组）。

要查看是否支持其他资源的增量查询，请转到此页面，选择 API 并转到其文档中的请求标头段落。如果您在描述中发现带有

odata.maxpagesize={x}. Optional.

的标题 - 它是受支持的。

截至今天（2018 年 7 月），以下 API 支持

odata.maxpagesize

参数：event、mailFolder、message、contactFolder、contact 以及以下 不 支持：group、user、driveItem、plannerUser。

随意使用Graph Explorer，因为它可能对故障排除非常有帮助。