使用员工学习 API 与 Viva Learning

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

Viva Learning是 Microsoft Teams 中的集中式员工学习中心，可让员工将学习和培养技能集成到日常工作中。 在Viva Learning中，团队可以发现、共享、推荐和学习其组织和合作伙伴提供的内容库。 他们可以快速访问分配或最近完成的学习内容，并在不离开 Microsoft Teams 的情况下完成所有这些操作。

Microsoft Graph 中的员工学习 API 使应用能够使学习管理系统 (LMS) 或学习提供程序中的内容在 Viva Learning 中可用。 使用以下资源与 Viva Learning 集成：

• 用于管理学习提供程序的学习提供程序，包括注册和删除提供程序。
• 学习内容，用于在 Viva Learning 中上传和管理 LMS 或学习提供商的学习内容元数据。
• 学习课程活动，用于在 Viva Learning 中从 LMS 或学习提供商上传和管理学习者课程活动记录。

集成的工作原理是什么？

作为管理员，你可以使用现成的集成（Viva Learning可以从 LMS 或学习提供商提取内容元数据和学习记录），将内容和学习者) 记录 (员工作业以及来自 LMS 或学习提供商的已完成课程记录与Viva Learning集成。 还可以使用 Microsoft Graph 中的员工学习 API 将内容元数据从 LMS 或学习提供程序推送到Viva Learning。

将内容元数据、员工作业及其已完成的课程记录上传到Viva Learning时，它们将显示在以下位置的Viva Learning中：

• 同步内容元数据后，内容将显示在主页的 “浏览课程 – 提供程序 ”部分下。
• 同步学习课程活动后，作业、建议和自学课程记录将显示在 “我的学习 ”选项卡上。根据进度，状态将从“ 正在进行” 更改为 “已完成”。

学习者的学习课程活动可以通过 API 在Viva Learning之外发现。

Authorization

借助适当的委派或应用程序 员工学习权限，你的应用可以使用员工学习 API 来管理租户中学习中心的学习提供程序及其内容。 有关访问令牌、应用注册以及委派和应用程序权限的详细信息，请参阅 身份验证和授权基础知识。

Microsoft Graph 中员工学习 API 的用例

使用员工学习 API 执行以下操作：

• 管理学习提供程序：
  • 向Viva Learning注册提供程序，提供显示名称、在学习内容卡上显示的方形徽标，以及显示在“详细信息”页中的长徽标，这是提供程序内容在Viva Learning中显示所必需的。 返回的注册 ID 可用于对内容引入进行后续调用。
  • 获取特定 registrationId 的 Viva Learning 中提供程序的详细信息。 
  • 获取租户Viva Learning中的提供程序注册列表。
  • 删除Viva Learning中提供程序的注册。
• Create和管理学习内容：
  • 将内容元数据推送到Viva Learning，使内容在Viva Learning内可供用户使用。 
  • 使用提供程序的 registrationId获取提供程序引入内容的元数据列表。 
  • 获取Viva Learning中提供程序引入内容的指定元数据。
  • 删除提供程序引入内容的指定元数据。
• Create和管理学习课程活动：
  • 获取用户的课程列表
  • 在 Viva Learning 中Create新的学习课程活动。
  • 使用 learningCourseActivityId获取学习课程活动的详细信息。
  • 使用 learningCourseActivityId更新学习课程活动的详细信息。
  • 删除学习课程活动

后续步骤

• 使用 Teams 中的协作功能启用员工学习。
• 在 Graph 资源管理器中试用员工学习 API。