Microsoft Graph REST API v1.0 终结点参考

欢迎使用终结点的 v1.0 Microsoft Graph REST API 参考。

终结点上的 API 集 v1.0 (https://graph.microsoft.com/v1.0) 已正式发布 (正式发布,) 状态,并与客户进行了严格的评审和反馈过程,以满足实际的生产需求。 此终结点上的 API 汇报本质上是累加的,不会中断现有应用方案。

常见用例

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

其中一些服务旨在实现围绕 用户的丰富方案。

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

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

1.0 版中的 Microsoft 365 组用例

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

其他 API 版本

目前有两个版本的 Microsoft Graph REST API - v1.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

最近更新

了解 v1.0 终结点中的 新增功能

浏览 API 更改日志 ,了解有关 Microsoft Graph API 更改的更多详细信息。