什么是 Microsoft Graph 工具包

已完成

生成 Web 应用并希望将其连接到 Microsoft 365 时，需要实现授权并调用 Microsoft Graph 来检索存储在 Microsoft 365 中的数据。

为了简化此流程，Microsoft Graph 工具包提供了一组 Web 组件和身份验证提供程序，用于将 Web 应用连接到 Microsoft 365。

在本单元中，你将了解什么是 Microsoft Graph 工具包以及为何要使用该工具包。 你还将了解可使用该工具包的不同类型应用。

Microsoft Graph 工具包概述

Microsoft Graph 工具包是一组 Web 组件，可与任何 JavaScript 框架一起使用，以将应用连接到 Microsoft 365。 在应用中加载工具包后，可以访问一组自定义 HTML 标记。 使用这些标记，可以从 Microsoft 365 加载数据。

例如，要为当前用户显示即将举行的会议列表，可在应用中包含以下代码片段：

<mgt-agenda></mgt-agenda>

然后，应用将呈现：

Microsoft Graph 工具包会定期使用新组件和功能进行更新。

为什么要使用 Microsoft Graph 工具包？

在前面的示例中，你是否注意到不需要发出单个 Web 请求？ 这正是应当考虑使用 Microsoft Graph 工具包的原因。

• 专注于构建自己的 Web 应用： Microsoft Graph 工具包取消了授权并连接到 Microsoft Graph。 无需担心授权、生成 Web 请求、处理响应和处理异常。
• 自定义呈现以匹配 Web 应用： 所有 Microsoft Graph 工具包组件都可供使用。 默认情况下，这些组件使用 Fluent UI（Microsoft 365 设计语言）显示数据。 每个组件还公开一个模板，允许你自定义呈现的数据。

何时使用 Microsoft Graph 工具包？

在为 Microsoft 365 生成 Web 应用和扩展时，可以使用 Microsoft Graph 工具包。

• 在 Web 应用中使用 Microsoft Graph 工具包： Microsoft Graph Toolkit 最适合在 Web 应用程序中使用。 通过最小配置，用户可以使用其 Microsoft 365 帐户登录到你的应用。 使用不同的组件，可以直接从 Microsoft 365 加载数据，从而增加应用的价值。
• 使用 Microsoft Graph 工具包生成 Microsoft 365 扩展： 在为 Microsoft 365 生成扩展（如 Teams 选项卡或 SharePoint 框架 Web 部件）时，也可以使用 Microsoft Graph 工具包。 为生成这些扩展，工具包附带提供程序，以使用 Microsoft 365 公开的现有身份验证信息。
• 在任何 JavaScript 框架中使用 Microsoft Graph 工具包： Microsoft Graph 工具包 Web 组件适用于任何 JavaScript 框架。 如果使用 React 生成 Web 应用，已有一个专为 React 制作的工具包。 此包将工具包的组件打包在 React 组件中，以便更轻松地将复杂数据传递到组件中，以及配置事件处理程序。

在 Web 应用中加载 Microsoft Graph 工具包

如果在不使用捆绑程序的情况下生成 Web 应用，则可以直接从内容交付网络加载Microsoft Graph 工具包。 要从内容交付网络加载工具包，请将以下代码片段添加到 Web 应用：

<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>

如果处理使用 npm 等包管理器的项目，请通过安装 @microsoft/mgt 包将 Microsoft Graph 工具包添加到 Web 应用：

npm install @microsoft/mgt

如果生成 React 应用，请改为安装 @microsoft/mgt-react 包：

npm install @microsoft/mgt-react

继续