账户设置

本文概述了如果贵组织正在进行域名更改，并且您需要更新当前 Udemy Business 帐户的域名，您可以采取的步骤。 

例如，如果公司 EXAMPLE A 要更名为公司 EXAMPLE ABC，则 Udemy Business 域名需要从 examplea.udemy.com 更改为 exampleabc.udemy.com。

提交更新 Udemy Business 帐户域名的请求

虽然帐户的当前域名列在管理工具的自定义外观部分，但在初始设置后，管理员将无法在此页面上更改它。域名更改需要 Udemy 的协助。

Enterprise 方案客户：如果您是 Enterprise 方案客户，请直接联系您的客户成功经理或 Udemy 联系人申请更改域名。 他们将指导您完成必要的步骤，并与我们的内部团队协调，以确保顺利过渡。您也可以联系 Udemy Business 支持。

Team 方案客户：如果您是 Team 方案客户，请联系 Udemy Business 支持，获取有关更改帐户域名的帮助。

面向使用集成的客户的重要注意事项

如果贵组织使用 Udemy Business 集成，例如：

• 单点登录 (SSO)
  
  
• 学习管理系统 (LMS)
  
  
• API 访问
  

请确保在更改后更新所有相关配置 URL 中的域名。否则，可能会导致登录错误、课程同步问题或 API 故障。

您可以在 Udemy Business 帐户的设置部分自定义帐户外观、启用访问功能和配置集成，例如单点登录 (SSO)。要访问“设置”区域，请点击管理 > 设置。

您可以在“设置”中执行以下操作：

• 自定义帐户外观 - 徽标、图标、背景
• 使用已批准的电子邮件域为用户提供“自助”访问
• 从身份提供程序启用单点登录 (SSO) 访问 
• 使用 SCIM 配置自动化用户和群组管理
• 访问课程和报告 API 以及文档 
• 为访问遭拒的用户自定义消息传递和联系人

请注意：虽然您可能会在您的帐户设置中看到您的域（即 company.udemy.com），但您将无法更改此设置。

• 如果您有企业帐户，请联系您的客户成功合作伙伴以更改您的域。
• 如果您有 Team 方案帐户，请联系我们的支持团队寻求帮助。请确保为您的组织提供您想要的新域。

要自定义您帐户的外观，请上传三张图片：一个徽标、一张背景图片和您公司的标志。前往管理 > 设置 > 自定义外观

1. 徽标： 上传采用以下格式之一的徽标： jpg、jpeg、gif、png、bmp。徽标应至少为 400x70 像素。
2. 背景图片：为您的登录页面上传一幅背景图片。图片应至少为 1920x1080 像素。
3. 图标：上传可选的方形标识以用作浏览器图标。 图标应至少为 32x32 像素。

本文说明了管理员如何设置 Power BI 来访问 Udemy Business API 并使用适用的数据进行报告。 

请注意，本指南专门介绍如何连接和使用用户-课程活动 API 端点。

目前，Udemy 不提供其他 API 端点的 Power BI 模板。如果您希望连接到其他端点，需以现有模板为参考，自行创建 Power BI 查询。

• 查看 Udemy Business API 的最佳实践。
• 了解有关 Udemy Business API 参考的更多信息。

设置 Power BI 以访问 Udemy Business API

1. 以管理员权限登录您组织的域。例如，您的组织 URL 应类似于以下示例：https://{your_domain}.udemy.com/organization/home/。

2. 在 API 集成页面启用 API。
前往“管理”>“设置”>“API 和集成”> 选择 API 的选项卡并选择“创建凭据”
（例如：https://{your_domain}.udemy.com/organization-manage-v2/settings/lms-integration/）

3. 将此屏幕中的“客户端 ID”和“客户端密钥”复制到记事本，然后在文档下，单击 API 文档链接。然后转到左侧边栏中的“列出用户课程活动”（示例：https://{your_domain}.udemy.com/developers/organization/reporting/methods/organizationusercourseactivity-list/get/）。

4. 插入客户端 ID 和客户端机密。这将生成您将在 Power BI 上使用的授权令牌。

5. 复制授权，打开文件 PowerBI_template，进行以下替换并保存文件：将 [insert-token] 替换为 authorization；将 [insert-customer-domain] 替换为 yourdomain；将 [insert-AccountID] 替换为 Organization_ID。

6. 打开 Power BI 桌面。

7. 创建一个新的 DataSource Web，键入组织的主页（示例：https://{your_domain}.udemy.com/），匿名身份验证。

注意：如果您在使用匿名身份验证时遇到“访问资源被禁止”错误，请跳到第 8 步。

8. 当系统完成连接时，单击“取消”并转到“获取数据”>“空白查询”。

9. 单击“高级编辑器”，选择保存在 PowerBI_template 上的所有信息，接着复制模板并粘贴到“高级编辑器”中，然后单击“完成”。

10. 等待数据填充完成，即可从该 API 端点获取所需的全部数据。

• 注意：如果您收到错误消息“未找到列‘第 1 列’”，则表示没有数据。

本文简要介绍了 Udemy Business 管理员如何查找其 Rest API 凭据，以将 Udemy 与 LMS、 LXP 或其他第三方系统集成。

请注意：

• API 仅适用于 Enterprise 客户。
• API 设置仅可由管理员访问。
• 本文不适用于 xAPI 凭据。了解更多信息：Udemy Business xAPI。
• 本文不适用于 GraphQL API 凭据。查看如何启用 Udemy Business GraphQL。

如何在 Udemy Business 中启用和查找您的 API 凭据

1 - 单击 Udemy Business 右上角的管理 。

2 - 单击左侧边栏的设置，然后单击 API 和集成。从下拉菜单中选择您将与之集成的系统，或者，如果您的工具未列出，请选择其他。单击保存。您的 API 现在已启用。

3 - 您的 4 个 Rest API 凭据将在下面的屏幕中提供。

帐户名称/子域
帐户 ID
客户端 ID
客户端密钥

注意 - 除了 Rest API 或 GraphQL 之外，某些集成还使用 xAPI 凭据来同步报告洞察分析。如果您的集成不需要 xAPI，则可以关闭此功能。否则，请按照您的集成合作伙伴的说明进行操作，或查看 Udemy 的 xAPI 说明以启用此服务。

使用 Udemy Business Web API (REST/GraphQL/xAPI)，可以轻松地将您的管理工具、LMS 平台和人力资源套件与 Udemy 的课程目录（通过元数据）和学习者参与数据关联起来。

通过以下方式增强工作场所的学习：

• 自动同步 Udemy Business 和您的员工目录（例如 Okta、Azure）之间的用户数据
• 在您的人力资源系统中嵌入搜索、发现和启动 Udemy Business 课程和课程讲座。
• 直接从应用程序中获取组织的实时课程参与度分析

Udemy Business Web API 使您能够将一流行业讲师的世界级技能发展融入员工的日常工作流程。通过 Udemy 的沉浸式视频课程、精心策划的学习路径、动手实验、评估等，提升您的员工在顶级业务、技术和领导能力方面的技能。开始免费试用 Udemy Business，亲身体验 API。 

• 要查看 Udemy API 许可协议 ，请访问：https://www.udemy.com/terms/api/
  • 注意：根据贵公司注册 Udemy Business 帐户的方式，您可能需要遵守额外或不同的条款，这些条款列示在贵公司签署的协议中。

请注意：访问此工作区中的 Udemy Business API 需要 Enterprise Udemy Business 订阅。如果您是现有客户，如果您需要此工作区中 API 的帮助，请联系 Udemy Business 支持人员。如果您还不是 Udemy Business 客户，请联系 sales@udemy.com。如果您希望成为 Udemy 的技术合作伙伴，请向我们的合作伙伴团队 提交申请。

可用 API 概述

Udemy Business Postman API 工作区包含两种类型的 Udemy Business API：

• REST - 将 Udemy Business 课程目录和学习者参与度数据集成到您的系统中
• GraphQL - 搜索课程和讲座元数据，并实施更新

xAPI

Udemy Business 还提供 xAPI 近实时服务。xAPI（或体验 API）是一种电子学习数据和规范接口标准，用于在广泛学习活动的上下文中收集和共享有关学习者体验的数据。Udemy 的 xAPI 服务发送以下与学习者的课程进度和完成情况相对应的动词：

1. 进度事件
2. 完成事件

当事件在 Udemy 中发生时，这些 xAPI 语句会近乎实时地发布到您的 xAPI 兼容系统（例如 LMS/LXP）。请注意，并非所有 LMS 或 LxP 系统都支持 xAPI。请与这些供应商联系以获得他们的支持。有关 Udemy Businesss xAPI 的更多信息，请访问我们的帮助中心文章。要进行设置，请查看此帮助中心资源。支持 xAPI 的集成的主要好处也可以在前面的文章中找到。

启用您的 Udemy Business 客户端 API：
只有 Udemy Business 管理员才能启用 REST 或 GraphQL API。

1. 以管理员身份登录您的 Udemy Business 网站。
2. 对于 REST API，导航到管理/设置/LMS/LXP 集成（它不仅仅是 LMS 或 LXP 集成，但这些系统往往是 Udemy 的常见集成点）
   1. 启用集成；您可以选择“自定义集成”来设置通用名称。
   2. 在 API 客户端（或此 Postman Collection - 请确保将 Postman Collection 复制到您的非公开工作区）中使用客户端 ID 和客户端密钥
3. 对于 GraphQL API，请导航到 https://ACCOUNT_NAME.udemy.com/dev-portal/api-clients/，其中 ACCOUNT_NAME 是您唯一的子域和 Udemy Business 虚拟 URL。
4. 从 API 客户端页面，激活 GraphQL API。

热门用例

无论您使用 LMS、HCM 平台还是自定义管理门户，您都可以将 Udemy Business API 用于各种用例。以下用例是最常见的：

发现并启动课程

• 从您的内部系统（例如，学习管理系统或学习体验平台）中搜索和浏览数千门 Udemy Business 课程
• 从内部系统启动 Udemy Business 课程（或课程讲座）时，启用单点登录 (SSO) 以无缝访问您的 Udemy Business 网站
• 在内部系统中跟踪学习者的课程分配、进度和完成情况

报告和分析

• 导入全面的参与数据
• 分析课程注册、进度和成绩
• 将学习与技能发展举措相结合
• 与更广泛的 L&D 战略和目标保持一致

技能差距分析

• 将员工技能差距与相关的 Udemy Business 课程或课程讲座相匹配
• 个性化建议的课程或课程讲座，以解决技能差距
• 通过有针对性的建议更高效地加入

与我们的解决方案工程团队合作，获得量身定制的集成体验。联系 Udemy Business，探索合作机会。

最佳实践

优化 Udemy Business API 集成

使用 SSO 实现无缝的学习者访问：

• 使用识别系统为您的 Udemy Business 应用程序配置 SAML 2.0 或 SCIM，以实现轻松的用户登录和课程访问
• 自动创建和更新帐户
• 集中访问您的 Udemy Business 企业学习平台

课程数据首选 GraphQL：

• 增量更新以实现最佳同步与批量加载
• 使用内置缓存避免重复调用
• 使用语义搜索获得最佳课程和课程讲座匹配

筛选、排序、分页：

• 利用查询参数仅检索相关数据
• 控制成绩结果集

评估复杂性以防止过度获取：

• 分析 API 呼叫量和频率
• 实施速率限制以防止滥用
• 执行负载测试以验证可扩展性

遵循 API 最佳实践可确保 Udemy Business 与您的核心人力资源或其他第三方系统之间实现高性能、可持续的集成。Udemy Business 销售和解决方案工程师可以建议对您的用例和基础设施量身定制的集成战略。

帮助和支持

如果您有任何问题，请联系我们的客户支持团队或合作伙伴支持团队。

本文章概述当有人提交请求，要求合并与其公司相关的 Udemy Business 网站时，帐户所有者如何才能批准学习数据迁移。 

• 了解更多有关合并多个 Udemy Business 网站的信息。

请注意：两个帐户所有者都批准迁移后，源网站将进入维护模式，用户将无法访问 Udemy for Business。请务必查看下方有关维护模式的章节。

目录

• 开始数据迁移流程
• 源网站审批流程
• 目标网站审批流程
• 有关批准后的维护流程的重要信息
• 有关 SSO 和 SCIM 集成的重要说明

开始数据迁移流程

您的客户成功合作伙伴开始迁移流程后，两个网站（源和目标 Udemy Business 网站）的帐户所有者都将收到一封电子邮件以批准迁移。 

源网站审批流程

如果您是源网站的帐户所有者： 

1.点击开始批准流程。然后，按照指示登录您的 Udemy Business 帐户。 

请注意：如果您使用单点登录 (SSO) 登录并被重定向到主页，请再次单击“开始审批”按钮以继续。

2. 输入目的地 URL（您希望将数据迁移到的位置），然后点击继续。

请务必输入正确的 URL。否则，您将收到一条错误消息并且不能继续操作。

3. 查看信息，勾选框，然后单击批准以同意迁移数据。 

4. 您将收到确认弹出信息，通知您迁移正在进行中。 

目标网站审批流程

如果您是目标网站的帐户所有者：

1.点击开始批准流程。然后，按照指示登录您的 Udemy Business 帐户。 

请注意：如果您使用单点登录 (SSO) 登录并被重定向到主页，请再次单击“开始审批”按钮以继续。

2. 输入源头 URL（您希望从中迁移数据的位置），然后点击继续。

请务必输入正确的 URL。否则，您将收到一条错误消息并且不能继续操作。

3. 查看信息，勾选框，然后单击批准以同意迁移数据。

4. 您将收到确认弹出信息，通知您迁移正在进行中。

有关批准后的维护流程的重要信息

两个帐户所有者都批准迁移后，源网站将进入维护模式，这意味着用户将无法访问 Udemy for Business 网站。源网站中的所有集成（如 SSO、SCIM 或 LMS）也将被禁用，以便保留要迁移的数据。 

有关 SSO 和 SCIM 集成的重要说明

作为迁移流程的一部分，SSO 和 SCIM 集成将在源网站被禁用。迁移流程完成后，管理员将需要在其 SSO 和 SCIM 身份提供程序内为迁移过来的用户授予访问权限。 

• 了解更多有关Udemy Business SSO 及其核心功能的信息。
• 查看如何使用 SCIM 自动化用户和群组管理。

如果您有兴趣合并两个或多个 Udemy Business 网站，本文概述了请求更多信息的初始步骤。

例如，如果贵公司有两个 Udemy Business 网站（例如一个地区网站 uk-company.udemy.com 和一个全球网站 company.udemy.com），您可以申请将它们合并。这意味着用户和他们的学习历史记录将从一个网站转移到一个域中。

Udemy Business 支持将 Enterprise 方案或 Team 方案网站合并为 Enterprise 方案网站。换言之，我们不支持合并两个 Team 方案网站或将 Enterprise 方案网站合并到 Team 方案网站中。

目录

• 组合多个 Udemy Business 网站的原因
• 如何请求有关迁移 Udemy Business 网站的更多信息

组合多个 Udemy Business 网站的原因

下面列出了您可能想要合并 Udemy Business 网站的一些原因：

贵公司有多个 Udemy Business 帐户、合同和网站，您希望合并它们

• 您希望您的学习者能够在一个网站上轻松访问 Udemy Business。
• 您希望让整个公司从统一的视图查看学习者洞察分析。
• 贵公司可能正在进行合并或收购，两个网站都需要合并。

如何请求有关迁移 Udemy Business 网站的更多信息

1. 联系您的客户成功合作伙伴讨论您的合并要求，并确定您是否有资格使用免费合并流程，亦或是需要付费服务。

2. 联系我们时，请指出：

• 要从中移动数据的网站的源 URL。
• 您希望将数据迁入其中的网站的目标 URL。
• 源网站或目标网站是否使用 SSO、SCIM、LMS/LXP 或其他集成。
• 您在源网站中是否有公共学习路径或自定义类别，并希望将其复制到目标网站。
  • 注意：私有路径无法跨网站复制。
• 源网站和目标网站上是否存在重复用户。
  • 注意：网站合并过程中无法移动重复用户。
• 是否需要对电子邮件域名进行重新格式处理。

3. 您的客户成功合作伙伴将提交内部请求，以验证网站合并的商业可行性。

4. Udemy 团队审核请求后，他们将与您联系，提供有关可行性的最新信息。

5. 如果网站合并可行，他们将提供流程中的后续步骤，以进一步确定网站合并的范围。