Microsoft Graph 概述

Microsoft Graph 是 Microsoft 365 中通往数据和智能的网关。 它提供统一的可编程模型,可用于访问 Microsoft 365、Windows 10 和企业移动性 + 安全性中的海量数据。 使用通过 Microsoft Graph 访问的大量数据,为组织和使用者构建与数百万用户交互的应用。

Microsoft Graph、Microsoft Graph 数据连接和 Microsoft Graph 连接器可实现广泛的 Microsoft 365 体验,还能构建智能应用。

支持 Microsoft 365 平台的数据和服务

在 Microsoft 365 平台中,这三大组件让数据访问和传输变得轻松:

  • Microsoft Graph API 提供了一个终结点 https://graph.microsoft.com,用于访问 Microsoft 云中丰富的以人为中心的数据和见解,包括 Microsoft 365、Windows 和企业移动性 + 安全性。 你可使用 REST API 或 SDK 来访问终结点并构建支持横跨生产力、协作、教育、人员和工作场所智能等 Microsoft 365 场景的应用。 Microsoft Graph 还包含一组功能强大的服务,可管理用户和设备标识、访问、合规性和安全性,并帮助保护组织防止数据泄露或丢失。
  • Microsoft Graph 连接器按传入方向工作,将 Microsoft 云外部的数据传送到 Microsoft Graph 服务和应用程序,以增强 Microsoft 搜索等 Microsoft 365 体验。 许多常用数据源中均存在连接器,如 Box、Google Drive、Jira 和 Salesforce。
  • Microsoft Graph 数据连接提供了一组工具,可更加轻松地以安全且可扩展的方式向热门 Azure 数据存储传递 Microsoft Graph 数据。 缓存数据充当 Azure 开发工具的数据源,可用于构建智能应用程序。

Microsoft Graph API、连接器和 Data Connect 共同为Microsoft 365平台提供支持。 借助可访问 Microsoft Graph 数据和其他数据集的能力,你可以获取见解和分析、扩展 Microsoft 365 体验和构建唯一而智能的应用程序。

Microsoft Graph 提供了哪些内容?

Microsoft Graph 公开了 REST API 和客户端库,它们可访问以下 Microsoft 云服务上的数据:

  • Microsoft 365 核心服务:Bookings、日历、Delve、Excel、Microsoft 365 合规性电子数据展示、Microsoft 搜索、OneDrive、OneNote、Outlook/Exchange、人员 (Outlook 联系人) 、Planner、SharePoint、Teams、To Do Viva Insights
  • 企业移动性 + 安全性服务:高级威胁分析、高级威胁防护、Microsoft Entra ID、Identity Manager和Intune
  • Windows 服务:活动、设备、通知、通用打印
  • Dynamics 365 Business Central 服务

要了解详细信息,请参阅 Microsoft Graph 中的主要服务和功能

显示属于Microsoft Graph的主要资源和关系的图像

可以使用 Microsoft Graph 执行哪些操作?

使用 Microsoft Graph 围绕用户的唯一上下文构建体验,帮助他们提高工作效率。 假设有个应用...

  • 查看你的下一场会议,提供与会者职务和所属经理、其正在处理的最新文档相关信息,以及其正在与之协作的人员等与会者个人资料信息,帮助你为该会议做好准备。
  • 扫描你的日历,并为下一次团队会议提出最佳时间建议。
  • 从 OneDrive 中的 Excel 文件获取最新销售预测图表,让你可以实时更新趋势预测,这一切通过手机就可以实现。
  • 订阅日历中的更改、当你在会议上花费太长时间时向你发送警报,并且还可以根据与会者和你的相关度,为可能错过或委派的会议提供建议。
  • 帮助你整理手机上的个人和工作信息;例如,对应当归到个人 OneDrive 的照片和应当归到 OneDrive for Business 的业务收据进行分类。
  • 分析大量 Microsoft 365 数据,让决策者们能将宝贵的见解转化成能提升业务生产力的时间分配和协作模式中。
  • 将自定义业务数据引入到 Microsoft Graph,编制相关索引,使其可与来自 Microsoft 365 服务的数据一起供用户搜索。

以搜索与会者的第一个场景为例。 借助 Microsoft Graph API,你可执行以下操作:

  1. 获取会议活动与会者的电子邮件地址。
  2. 以Microsoft Entra ID用户身份单独查找他们以获取其个人资料信息

然后,可顺着人际关系导航到其他联系人:

若要了解详细信息,请参阅 集成模式

Microsoft Graph 不断向开发人员开放 Microsoft 365 平台,且始终仅使用适当的全向。

注意

使用 Microsoft Graph API 即表示你同意 Microsoft API 使用条款Microsoft 隐私声明

查看可与 Microsoft Graph API 结合使用的某些常见方案。 这些链接可带你前往 Graph 浏览器

操作 URL
获取我的个人资料 https://graph.microsoft.com/v1.0/me
获取我的文件 https://graph.microsoft.com/v1.0/me/drive/root/children
获取我的照片 https://graph.microsoft.com/v1.0/me/photo/$value
获取我的邮件 https://graph.microsoft.com/v1.0/me/messages
获取我的高重要性的邮件 https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
获取我的日历事件 https://graph.microsoft.com/v1.0/me/events
获取我的经理 https://graph.microsoft.com/v1.0/me/manager
获取上一个修改文件 foo.txt 的用户 https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
我所属的 GET Microsoft 365组 https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
获取我组织中的用户 https://graph.microsoft.com/v1.0/users
获取我组织中的组 https://graph.microsoft.com/v1.0/groups
获取与我相关的人员 https://graph.microsoft.com/v1.0/me/people
获取我常用的项目 https://graph.microsoft.com/beta/me/insights/trending
获取我的笔记 https://graph.microsoft.com/v1.0/me/onenote/notebooks

将外部内容源中的数据引入Microsoft Graph

使用 Microsoft Graph 连接器将 Microsoft 云外部的数据引入 Microsoft Graph。 此类数据的示例可以是组织的人力资源数据库或产品目录,它们在本地托管或在公有云或私有云中托管。

Microsoft Graph 连接器创建与外部数据源的连接、对数据编制索引并将其作为外部自定义项和文件进行存储。 编制索引后,这些项目可以显示在 Microsoft 搜索中,并显示在使用 Microsoft 搜索 API的应用中。

批量访问 Microsoft Graph 数据

使用 Microsoft Graph 数据连接 大规模访问 Microsoft Graph 上的数据,同时允许管理员精细同意并完全控制其 Microsoft Graph 数据。 通过数据连接,可更轻松地将此数据传递到 Microsoft Azure。

之后,可使用 Azure 工具构建能实现以下功能的智能应用:

  • 在组织中查找与你最接近的主题专家。
  • 自动创建知识库。
  • 分析会议请求以提供有关会议室利用率的见解。
  • 使用生产力和通信数据检测欺诈行为。

应何时使用 Microsoft Graph API 或数据连接?

使用 Microsoft Graph 数据连接,可以一种新方式与通过 Microsoft Graph API 公开的数据进行交互。 数据连接提供了一套独特的工具,简化了智能应用程序的构建,且所有操作均在 Microsoft 云中完成。

功能 Microsoft Graph API Microsoft Graph 数据连接
访问范围 单个用户或整个租户 多个用户或组
访问模式 实时 定期重复
数据操作 对主数据执行操作 对数据缓存执行操作
数据保护 保护 Microsoft 365 中的数据 数据保护延伸至 Azure 订阅中的数据缓存
用户同意 自我
资源类型
管理员同意 整个组织
资源类型
选择用户组
资源类型和属性
排除用户
访问工具 RESTful Web 查询 Azure 数据工厂