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

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

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

常见用例

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

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

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

• 获取用户的个人资料 和 照片 。
• 获取用户的经理的个人资料信息及其直接下属的 ID，全部存储在Microsoft Entra ID中。
• 在 OneDrive 上访问用户的文件，找到修改文件的最后一个人的身份，然后转到该用户的个人资料。
• 在Exchange Online访问用户的日历，并确定在未来两周内与其团队会面的最佳时间。
• 订阅 并跟踪用户日历中的 更改 ，并告知用户在会议中花费的时间超过 80%。
• 在用户离开办公室时设置自动答复。
• 根据通信、协作和业务关系，获取与用户最相关的人员。
• 从用户 OneDrive 中 Excel 文件中的 图表 获取最新的销售预测。
• 在 Planner 中查找分配给用户的任务。

1.0 版中的 Microsoft 365 组用例

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

调用 v1.0 终结点

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

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

有关 Microsoft Graph REST API 调用的详细信息，请参阅使用 Microsoft 图形 API。

Microsoft Graph beta 终结点

目前，提供两个版本的 Microsoft Graph REST API：v1.0 和 beta。

如需了解仍处于预览状态的新 API 或增强 API，请参阅 Microsoft Graph beta 终结点参考。

警告

处于预览状态的 API 可能会更改，并且可能会中断现有方案，而不另行通知。 不要对终结点中的 beta API 进行生产依赖。

有关详细信息，请参阅 版本控制和支持。

新增功能

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

有关 v1.0 中 Microsoft Graph API 更改的详细信息，请浏览 API 更改日志。

相关内容

• Microsoft Graph 概述
• Microsoft Graph 浏览器
• Microsoft Graph 快速入门
• 使用 Microsoft Graph SDK