使用 Microsoft Graph API


所有这些不同服务的 API 通过一个名为 Microsoft Graph 的工具连接起来。它提供了一种使用多个 API 的单一方法,用户只需登录一次即可访问所有服务 API。如果您想直接访问一些核心 API,则需要分别为每个 API 注册。Microsoft Graph 有效地促进了开发者对 API 的使用。

使用 Microsoft Graph API,我们可以访问多个相关实体,例如 Microsoft 365 组、Teams 团队以及 SharePoint 文档库中的文档。例如,Microsoft 365 组和 SharePoint 团队站点共享主文档库。当您通过其站点对象检索有关文档库的信息时,您还会发现该组的 ID。实体信息可以通过多种方法检索,可以通过直接查询它们或使用相关实体来访问它们。例如,这两个 URL 将提供有关同一团队的信息;第二个 URL 检索底层的 Microsoft 365 组,然后是其链接的团队,而第一个 URL 使用团队对象的 ID 作为直接引用(相关组和团队具有相同的 ID)。

学习 Microsoft Graph API 的好处

Office 365 是 Microsoft Office 产品,在全球范围内使用最为广泛。Microsoft Graph API 有益于商业版本的 Microsoft Office 365 套件,或者其一个或多个组件,如 Outlook、OneNote 等,被数百万用户使用。

在任何办公室中,用户通常会花费 2 到 3 个小时在各种 Office 套件应用程序(如 Outlook、Excel、Project 等)上工作。Outlook 每天都会创建数百万封全新的电子邮件、事件和其他项目,而 OneDrive 则托管着数百万个文件。如果您希望访问存储在 Office 365 或 Azure 中的数据,则需要 MS Graph API。

Graph 资源管理器

提供了一个名为 Graph 资源管理器的基于浏览器的应用程序,以帮助用户了解有关 Graph 的更多信息。使用此工具,您可以使用示例租户或登录到您的租户以简单地对 Graph 进行调用。您可以快速创建必要的 HTTP 查询,并在浏览器中直接查看结果。您可以使用它来快速检查您的查询是否格式正确,查看您期望获取的数据是否存在,上面提到的 beta 和 v1.0 端点是否以相同的方式运行,或者版本之间是否存在更改。

在使用 Graph 资源管理器之前,租户管理员必须批准应用程序在租户内部的使用,并且通常还必须批准使用该工具执行必要任务所需的权限。只有管理员或所有用户才能提供他们使用任何内容的权限。

调用 Microsoft Graph API

您可以通过以下方式在您的应用程序中集成 Graph:

在您的代码中创建一个 HTTP 请求,然后立即调用 Graph。在您的应用程序之前放置一个 SDK 到 Graph 前面。SDK 的目的是进一步简化已经简单的 API 访问过程。以下系统和语言目前提供 SDK:Android、Angular、ASP.NET、iOS、Javascript、Node.js、Java、PHP、PowerShell、Python 和 Ruby。

此外,具有内置 Microsoft Graph 集成的 UI 元素可以在名为 Microsoft Graph Toolkit 的软件包中找到。

可以使用 MS Graph API 访问的组件

以下是可以使用 API 访问的关键 Microsoft Graph 部分:

  • Exchange 服务器和邮件(Outlook 帐户)。

  • 用于计划和组织事件的日历。

  • Office365 文档管理系统,用于文字处理器、电子表格和其他类型的文档。

  • Office 365 Planner API 允许您构建任务、添加将参与任务的个人,然后在利益相关者之间执行工作流。

  • 您可以使用 Microsoft One Drive 存储或 Sharepoint 文档库以各种格式共享文件和媒体。

  • 个人或网络组之间的对话和消息。

  • 快速访问 Microsoft One Notes。

  • 使用 Sharepoint 访问数据。

  • 如果没有任何内置格式适合您的需求,Microsoft Graph 使您可以自由创建自己的数据格式。

  • Microsoft Graph API 可用于推送通知。

身份验证

目标是从 Azure AD 获取访问令牌,然后必须将其放在发送到 Microsoft Graph 的每个 HTTP 请求的 Authorization 标头中。您可以在访问令牌中找到您被允许使用 Microsoft Graph 执行的操作。

在应用程序注册设置中建立权限时,我们应该始终坚持最小权限原则,这意味着我们应该只同意基本权限。因此,当您从 Graph 说明中检查所需的范围时,首选始终提供最少的权限。

在我们根据我们选择使用的 OAuth 流程的要求配置应用程序注册后,现在该向应用程序添加一些与身份验证相关的逻辑了。对于更简单的过程,您可以使用提供身份验证技术的库,或者可以使用直接的 REST 请求进行身份验证。

结论

新的面向服务的架构,即 Microsoft Graph(由 Microsoft 拥有),以前称为 Office 365 统一 API,使开发人员能够访问来自 Microsoft 云平台的大量数据。最后,您应该知道,根据目前的统计数据,81% 的财富 500 强企业在其系统中使用 Microsoft Graph。这是 Microsoft Graph 是一项在未来几年具有巨大潜力的技术的可靠证据。

更新于:2022-11-01

609 次浏览

启动您的 职业生涯

通过完成课程获得认证

开始
广告