-
配置和自定义您的帐户设置
阅读文章您可以在 Udemy Business 帐户的设置部分自定义帐户外观、启用访问功能和配置集成,如单点登录 (SSO) 和 Slack 共享。要访问“设置”区域,请点击管理 > 设置。
您可以在“设置”中执行以下操作:
- 自定义帐户外观 - 标识、图标、背景
- 使用已批准的电子邮件域为用户提供“自助”访问
- 从身份提供程序启用单点登录 (SSO) 访问
- 使用 SCIM 配置自动化用户和群组管理
- 访问课程和报告 API 以及文档
- 与 Slack 或 Workplace 集成以促进社交学习
- 为访问遭拒的用户自定义消息传递和联系人
更改您的域
虽然您可以在您的帐户设置中看到您的域(即 company.udemy.com),但您将无法更改此设置。
- 如果您有企业帐户,请联系您的客户成功合作伙伴以更改您的域。
- 如果您有 Team 方案帐户,请联系我们的 Udemy Business 支持团队以获得帮助。请确保为您的组织提供您想要的新域。
-
自定义我的帐户
阅读文章要自定义您帐户的外观,请上传三张图片:一个徽标、一张背景图片和您公司的标志。前往管理 > 设置 > 自定义外观
- 徽标: 上传采用以下格式之一的徽标: jpg、jpeg、gif、png、bmp。徽标应至少为 400x70 像素。
- 背景图片:为您的登录页面上传一幅背景图片。图片应至少为 1920x1080 像素。
- 图标:上传可选的方形标识以用作浏览器图标。 图标应至少为 32x32 像素。
-
如何设置 Power BI 以使用 Udemy Business API 数据
阅读文章本文说明了管理员如何设置 Power BI 来访问 Udemy Business API 并使用适用的数据进行报告。
- 查看 Udemy Business API 的最佳实践。
- 了解有关 Udemy Business API 参考的更多信息。
设置 Power BI 以访问 Udemy Business API
- 以管理员权限登录您组织的域。例如,您的组织 URL 应类似于以下示例: https://yourdomain.udemy.com/organization/home/
- 在 API 集成页面启用 API(例如:https://yourdomain.udemy.com/organization-manage/settings/api-integration/)。
- 从开始设置按钮,选择其他(示例:https://yourdomain.udemy.com/organization-manage/settings/lms-integration/),例如键入Power BI 并保存。此过程将生成客户端和机密 ID。
- 返回到 API > 报告 API,然后选择方法(示例:https://yourdomain.udemy.com/developers/organization/reporting/methods/organizationuseractivity-list/get/)。
- 插入客户端 ID 和客户端机密。这将生成您将在 Power BI 上使用的授权令牌;
- 复制授权,打开文件 PowerBI_Template,进行以下替换并保存文件:将 [insert-token] 替换为 authorization;将 [insert-customer-domain] 替换为 yourdomain;将 [insert-AccountID] 替换为 Organization_ID;
- 打开 Power BI 桌面;
- 创建一个新的 DataSource Web,键入组织的主页(示例:https://yourdomain.udemy.com/organization/home/),匿名身份验证。
注意:如果在使用匿名身份验证时收到“禁止访问资源”错误,请使用完整的 API 端点 URL,并将“身份验证”类型切换为“基本”。
输入如下所示的客户端 ID 和客户端机密(确保设置应用于 URL 的最高级别)
以这种方式设置身份验证意味着在后续流程的 Power Query 中不需要它。复制 Power Query 时,请确保从脚本中删除身份验证代码。
- 取消浏览器窗口,打开 DataSource 空白查询;
- 单击“高级编辑器”,选择您保存在 PowerBI_Template 上的所有信息,然后复制;
- 保存
注意:如果您收到错误消息“未找到列‘第 1 列”,则表示没有数据。
-
如何在 Udemy Business 中查找您的 API 凭据
阅读文章本文简要介绍管理员如何查找其 API 凭据,以将 Udemy Business 与学习管理系统 (LMS) 和学习体验平台 (LXP) 集成,或使用 Udemy Business REST API 进行其他自定义集成。
请注意:
- API 仅适用于企业客户。
- 本文不适用于 xAPI 凭据,可在您希望将数据从 Udemy Business 推送到的系统中找到它们。了解更多信息:Udemy Business xAPI。
- 有关集成的更多信息,请查看我们的 LMS 和 LXP 集成合作伙伴。
Udemy Business REST API 包含以下凭据。如果您的 API 已启用,则可以通过将 {{Org_Name}} 替换为您自己的子域,在以下 URL 中找到它们。
- 客户端 ID 和客户端密钥
- https://{{Org_Name}}.udemy.com/organization-manage/settings/lms-integration/
- 组织 ID(帐户 ID)
- https://{{Org_Name}}.udemy.com/developers/organization/courses/
- https://{{Org_Name}}.udemy.com/developers/organization/reporting/
- 组织名称(帐户名称)
- 这是您 URL 的子域:https://{{Org_Name}}.udemy.com
- 注意:如果您使用的是 SumTotal,则 Org Name 将是完整的 URL:https://{{Org_Name}}.udemy.com
如果您的 API 尚未启用,请按照以下说明启用您的 API 并检索凭据:
如何在 Udemy Business 中启用和查找您的 API 凭据
- 单击 Udemy Business 右上角的管理 > 设置。
- 单击侧栏上的 LMS/LXP 集成,然后单击开始设置。从下拉菜单中选择您将与之集成的系统,或者,如果您的工具未列出,请选择其他。单击保存。您的 API 现在已启用。
- 现在 API 已启用,您可以检索您的 API 凭据了。客户端 ID 和客户端密钥现在将在管理 > 设置 > LMS/LXP 集成下可用。
- 接下来,要查找您的组织 ID(帐户 ID),请单击左侧导航侧栏上的 API。然后,单击任一 API 文档链接
- 将页面向下滚动到您的 API 客户端和您的帐户 ID 小节。您将在此处找到您的 帐户 ID(与组织 ID 相同)
- 接下来,查找您的组织名称/帐户名称:它就是您的 Udemy Business URL 的子域:
现在您已从 Udemy Business 获得 API 凭据,您可以将这些凭据插入您的 LMS/LXP 或您希望与之集成的其他系统。
如果您对我们的 API 或设置集成有其他疑问,请随时联系您的专属客户成功经理寻求帮助。
-
Udemy Business Web API:用例和最佳实践
阅读文章使用 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:
xAPI
Udemy Business 还提供 xAPI 近实时服务。xAPI(或体验 API)是一种电子学习数据和规范接口标准,用于在广泛学习活动的上下文中收集和共享有关学习者体验的数据。Udemy 的 xAPI 服务发送以下与学习者的课程进度和完成情况相对应的动词:
- 进度事件
- 完成事件
当事件在 Udemy 中发生时,这些 xAPI 语句会近乎实时地发布到您的 xAPI 兼容系统(例如 LMS/LXP)。请注意,并非所有 LMS 或 LxP 系统都支持 xAPI。请与这些供应商联系以获得他们的支持。有关 Udemy Businesss xAPI 的更多信息,请访问我们的帮助中心文章。要进行设置,请查看此帮助中心资源。支持 xAPI 的集成的主要好处也可以在前面的文章中找到。
启用您的 Udemy Business 客户端 API:
只有 Udemy Business 管理员才能启用 REST 或 GraphQL API。- 以管理员身份登录您的 Udemy Business 网站。
- 对于 REST API,导航到管理/设置/LMS/LXP 集成(它不仅仅是 LMS 或 LXP 集成,但这些系统往往是 Udemy 的常见集成点)
- 启用集成;您可以选择“自定义集成”来设置通用名称。
- 在 API 客户端(或此 Postman Collection - 请确保将 Postman Collection 复制到您的非公开工作区)中使用客户端 ID 和客户端密钥
- 对于 GraphQL API,请导航到 https://ACCOUNT_NAME.udemy.com/dev-portal/api-clients/,其中 ACCOUNT_NAME 是您唯一的子域和 Udemy Business 虚 URL。
- 从 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。请务必查看下方有关维护模式的章节。
目录
开始数据迁移流程
您的客户成功合作伙伴开始迁移流程后,两个网站(源和目标 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 网站的已批准请求功能。
请注意:如果尚未获得批准,请与您的客户成功合作伙伴联系,因为 Udemy 保留评估每个请求的范围和可行性的权利。 例如,如果您的公司有两个 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 网站
1. 联系您的客户成功合作伙伴
2. 联系我们时,请指出:
- 要从中移动数据的网站的源 URL。
- 您希望将数据迁入其中的网站的目标 URL。
3. 您的客户成功合作伙伴将提供更多信息和后续步骤。
请注意:
- 迁移开始后,源网站将进入维护模式,用户将无法访问相应的 Udemy Business 域。
- 目标网站需要有足够的未使用许可证,迎接由源网站迁移而来的用户。
数据迁移资格
Udemy Business 订阅中包含的可用于迁移的数据类型
您的 Udemy Business 订阅目前包括以下类型的数据,这些数据有资格从一个网站传输到另一个网站:
- 用户资料
- 课程注册人数
- 课程进度
- 洞察分析和报告
可通过付费服务迁移的数据类型
目前,付费服务将某些类型的数据从一个站点迁移到另一个站点所必需的。这些类型包括但不限于:
- 用户角色(注意:作为迁移流程的一部分,所有用户都会被分配用户角色。如有必要,随后还可以在目标网站中为用户分配管理员或群组管理员角色)
- 导入课程
- 了解更多有关将课程从 Udemy.com 导入到您的 Udemy Business 帐户的信息
- 如果需要付款的课程还有多余的许可证,请联系 Udemy Business 支持团队,因为这门课程需要导入到目标网站。
- 小组
- 章节
- 已获批准的域配置
- LMS 配置
- SCIM 数据
- SSO 数据
- 待处理邀请
- 课程排除(如果课程排除适用于目的地组织,请联系 Udemy Business 支持团队)。
- 自定义分类
- 自定义课程
- 自定义学习路径
- 学习路径注册人数
- 课程分配
请注意:Udemy 将“合并组织”作为一项付费服务提供,以填补其中的一些空白,并确保合并过程顺利进行。目前并非每个国家或地区都提供付费服务。 如果您有兴趣了解更多信息,我们建议您与您帐户的客户成功合作伙伴联系。 无法迁移的数据类型
此时无法传输以下类型的数据:
- 重复用户 - 如果您有任何重复学员,即一位学员在两个网站上使用相同的电子邮箱地址,则该学员的数据不会被传输。他们在目的地网站的数据将被保留。
- 订阅详情(还有可用的许可证)
导出未迁移的数据
可以导出规划的课程、学习路径、组和章节的数据,以便在目标 Udemy Business 网站上重新创建它们(如有必要)。
- 了解如何生成并下载数据导出报告。
- 查看如何生成和下载学习路径报告。
有关 SSO 和 SCIM 集成的重要说明
作为迁移过程的一部分,在源站点合并期间,SSO 和 SCIM 集成将被禁用。迁移流程完成后,管理员将需要在其 SSO 和 SCIM 身份提供程序内为迁移过来的用户授予访问权限。
- 了解更多有关Udemy Business SSO 及其核心功能的信息。
- 查看如何使用 SCIM 自动化用户和群组管理。