Microsoft Graph REST API 1.0 版参考

欢迎使用 1.0 版终结点的 Microsoft Graph REST API 参考。

1.0 版终结点 (https://graph.microsoft.com/v1.0) 上的 API 集处于一般可用 (GA) 状态,并经过与客户进行严格的审查和反馈流程,以满足实际的生产需求。 此终结点上的 API 更新本质上可以累加,并且不会破坏现有应用场景。

常见用例

Microsoft Graph 的强大之处在于可以在单个 Microsoft Graph REST 终结点公开的不同服务之间轻松导航实体和关系。

很多服务旨在围绕用户实现丰富的应用场景。

1.0 版中以用户为中心的用例

  1. 获取用户 Lisa 的个人资料照片
  2. 获取 Lisa 的经理的个人资料信息她的直接下属的 ID,全都存储在 Azure Active Directory 中。
  3. 访问 Lisa 在 OneDrive for Business 上的文件,查找最后修改文件的人员的身份,并导航到此人的个人资料。
  4. 在 Exchange Online 中访问 Lisa 的日历,并确定 Lisa 与团队成员在接下来的两周内会面的最佳时间
  5. 在 Lisa 的日历中订阅跟踪更改,当她花费在会议上的时间超过 80% 时通知她。
  6. 设置当 Lisa 不在办公室时的自动答复
  7. 根据通信、协作和业务关系,获取与 Lisa 最相关的人员
  8. 在 Lisa 的 OneDrive for Business 的 Excel 文件中,从一个图表获取最新销售预测。
  9. 在 Planner 中查找分配给 Lisa 的任务

1.0 版中的 Microsoft 365 组用例

  1. 对组织中的 Microsoft 365 组运行报告,并确定组成员之间通信最多的组。
  2. 查找此 Microsoft 365 组的计划,和该计划中的任务分配
  3. 在 Microsoft 365 组中启动新对话以确定成员是否要创建另一个组来分担工作负荷。
  4. 为组获取默认笔记本创建一个页面注明调查结果。

其他 API 版本

目前有两个版本的 Microsoft Graph REST API:1.0 版 和 beta 版。 如需了解仍处于预览状态的新 API 或增强 API,请参阅 Microsoft Graph beta 终结点参考。 请注意,预览状态的 API 可能会发生更改,并可能在无通知的情况下破坏现有应用场景。 不要对 beta 终结点的 API 产生依赖。

请参阅版本控制和支持了解更多信息。

调用 v1.0 终结点

针对 v1.0 终结点的 Microsoft Graph API 请求使用以下模式:

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

有关详细信息,请参阅使用 Microsoft Graph API

最近更新

了解 1.0 终结点的最新功能和更新

与我们联系

是否希望在 Microsoft Graph 中增加其他 API 或功能? 在 Microsoft 365 开发人员平台意见论坛上发布新的功能请求。

对现有 Microsoft Graph API 有反馈意见? 在 Github 上与我们联系。