Microsoft Graph 工具包 是可重复使用、与框架 无关的组件和身份认证提供程序的集合,用于访问和使用 Microsoft Graph。 这些组件开箱即可正常运行,附带的内置提供程序可以与 Microsoft Graph 进行身份验证并从之提取数据。
Microsoft Graph 工具包 可以使得在应用程序中使用 Microsoft Graph 变得轻松。 在下面的示例中,登录用户及其日历事件仅使用登录和议程组件显示两行代码。
<iframe src="https://mgt.dev/iframe.html?id=samples-general--login-to-show-agenda&source=docs&source=docs" height="400"></iframe>
Microsoft Graph 工具包中的内容是什么?
组件
Microsoft Graph 工具包包含 Web 组件的集合,用于 Microsoft Graph API 提供支持的最常见的生成体验。
这些组件还可作为 React 组件 使用。
| 组件 | 说明 |
|---|---|
| 登录 | 一个按钮和一个浮出控件,用于使用 Microsoft 标识平台对用户进行身份验证,并在用户登录时显示其个人资料信息。 |
| 人员 | 通过照片、姓名和/或电子邮件地址显示人员或联系人。 |
| 人员 | 按照照片或首字母缩写显示一组人员或联系人。 |
| 议程 | 在用户或组的日历中显示事件。 |
| 人员选取器 | 提供搜索人员和呈现结果列表的功能。 |
| 个人卡片 | 用于显示有关用户的更多个人资料信息的人员组件上的浮出控件。 |
| 文件 | 表示具有图标、文件名、作者等的文件或文件夹。 |
| 文件列表 | 显示多个文件或文件夹的列表。 |
| 获取 | 允许直接在 HTML 中对任何 Microsoft 图形 API进行 GET 查询。 |
| 频道选取器 | 提供搜索 Microsoft Teams 频道以从呈现的结果列表中选择频道的功能。 |
| 待办事项 | 显示并启用添加、删除、完成或编辑微软待办中的任务。 |
| Tasks | 显示并启用添加、删除、完成或编辑 Microsoft Planner 或微软待办中的任务。 |
提供程序
提供程序 启用身份验证,提供用于在各种平台上获取访问令牌的实现,并公开用于调用 Microsoft Graph API 的 Microsoft Graph 客户端。 组件在与提供程序一起使用时效果最佳,但提供程序也可以自行使用。
| 提供程序 | 说明 |
|---|---|
| MSAL | 使用 msal.js 登录用户并获取用于 Microsoft Graph 的令牌。 |
| MSAL2 | 使用 msal-browser 登录用户并获取用于 Microsoft Graph 的令牌。 |
| 电子 | 对电子应用中的组件进行身份验证并提供 Microsoft Graph 访问权限。 |
| SharePoint | 对 SharePoint Web 部件中的组件进行身份验证并提供对组件的 Microsoft Graph 访问权限。 |
| Teams | 使用msal.js在 Microsoft Teams 选项卡上登录用户并获取客户端上的令牌。 |
| Teams MSAL2 | 使用 msal-browser 在 Microsoft Teams 选项卡上登录用户和获取令牌。 支持使用自定义后端的单一登录 (SSO) 。 |
| 代理 | 通过后端将所有调用路由到 Microsoft Graph 以允许使用后端身份验证。 |
| 自定义 | 创建自定义提供程序,以使用应用程序的现有身份验证代码启用身份验证和访问 Microsoft Graph。 |
为什么要使用 Microsoft Graph 工具包?
借助 Microsoft Graph 工具包,可以快速轻松地将 Microsoft Graph 支持的常见体验集成到自己的应用程序中。 工具包:
-
缩短开发时间。 连接到 Microsoft Graph API 并在 UI 中呈现数据(看起来和感觉类似于 Microsoft 365 体验)的工作是为你完成的,无需自定义。
-
可在任何地方工作。 所有组件都基于 Web 标准,可与任何新式浏览器和 Web 框架 ((如 React、Angular 或 Vue) )无缝配合使用。
-
是美丽,但灵活。 这些组件的设计外观类似于 Microsoft 365 体验,但也可使用 CSS 自定义属性 和 模板进行自定义。
谁应该使用它?
Microsoft Graph 工具包非常适合所有体验级别的开发人员,他们想要开发连接到 Microsoft Graph 并访问数据的应用,例如:
- Web 应用
- Microsoft Teams 选项卡
- 渐进式 Web 应用 (PWA)
- 电子应用
- SharePoint Web 部件
在哪里可以使用它?
以下浏览器支持 Microsoft Graph 工具包:
|Microsoft Edge|Firefox|Chrome|Safari|Opera|Samsung Internet| |----|----|----|----|----|----|----| |Microsoft Edge|Firefox|Chrome|Safari|Opera|Samsung|
后续步骤
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 sebastienlevert)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
