面向管理员的 Google Workspace 集成简介

Google Workspace 可以与 Learn 相集成。当您的机构启用了 Google Workspace 后,教师可以通过其 Google Drive 访问文件,并将这些文件链接到 Ultra 课程中。文件包括在 Google Drive 中创建的文档、幻灯片和工作表。

教师可以将 Google Workspace 文件链接到课程资源区、学习模块和文件夹。教师对 Google Workspace 文件做出的所有更改均会应用到教师添加的每一个链接。

只有教师的“My Drive”文件夹中的文件才能通过 Google Workspace 链接到课程。

要集成 Google Workspace,您需要:

  1. 在 Learn 中注册 Google Workspace
  2. 在 Google Cloud 中配置 Google Workspace
  3. 在 Learn 中启用 Google Workspace 集成

第二步将要求您访问 Google 的官方文档。

在 Google Cloud 中配置 Google Workspace

Learn 支持在 Google Cloud 中注册的一个主域名下配置的多个域。如果您的机构管理多个域(例如,一个域供教师使用,另一个域供学生使用),则您可以在 Google Cloud 中添加用户别名域或辅助域。按照 Google Workplace 管理员帮助中的步骤操作。

您需要在 Google Cloud(也称为 Google 开发人员帐户)中配置您机构的设置。Google Cloud 位于 Learn 之外,必须使用您的 Google 凭证来访问。按照下面概述的步骤操作。

您可以在 PDF 文件中查看这些步骤的操作示例。详细信息请参阅下面每个步骤中链接的 Google 文档。

1. 设置新项目。请访问 Google 的帮助网站,了解如何为机构设置新项目。

2. 设置同意屏幕。请访问 Google 的帮助网站,了解如何为机构设置同意屏幕。要完成同意屏幕的设置,您需要通过在 Google Developer 帐号中手动输入URL https://www.googleapis.com/auth/drive 来添加范围。

3. Google 客户端配置。请访问 Google 的帮助网站,了解如何设置 Google 客户端配置。使用此表可标识重定向 URI。需要此 URI 才能完成此步骤。

不同区域的客户端 ID 表
客户端 ID地区重定向 URI
57dfd374-a957-4352-a6f8-9cf398a554ebus-east-1us.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
136cad97-f53f-4719-a320-be308424864beu-central-1eu.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
4f3043a9-2687-4f2b-8014-7d662142f3ebca-central-1ca.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
43dcf283-7e70-4594-9caa-30a16ce2b605ap-southeast-2au.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0dap-southeast-1sg.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
b863c2bb-2b80-45d1-af82-1a3e152eaaa8ap-northeast-2kr.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
5cf09ba6-60be-4b5b-aaf9-61f7f3c0be9caf-south-1sa.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

必须在 Google Cloud 中创建以下信息,以完成您的机构与 Google 的集成:

  • 客户端 ID
  • API 密钥
  • 客户端密钥
  • 服务帐户名称
  • 服务帐户凭证文件
  • 共享驱动器 ID

请访问 Google Workspace 帮助站点,了解如何获取所有必填信息。

您可以通过复制机构的 Workspace 的文件夹 ID 来获取共享驱动器 ID。您可以通过复制访问文件夹时在浏览器 URL 字段中显示的内容,来找到文件夹 ID。复制显示在 drive.google.com/drive/u/1/folders/ 之后的所有内容

Image of the UI for Google Workspace with the folder URL in the URL field of the browser

4. 从 APP 库启用 API。请访问 Google 的帮助网站以启用 Google API。您必须选择以下 API:

  1. Google Drive API
  2. Google Picker API

在 Learn 中注册 Google Workspace

1. 在 Learn 的机构管理员面板中,选择集成类别中的 LTI 工具提供程序

2. 选择注册 LTI 1.3 工具

3. 在“客户端 ID”字段中,键入或复制并粘贴您所在区域的客户端 ID。

不同区域的客户端 ID 表
地区客户端 ID
us-east-157dfd374-a957-4352-a6f8-9cf398a554eb
eu-central-1136cad97-f53f-4719-a320-be308424864b
ca-central-14f3043a9-2687-4f2b-8014-7d662142f3eb
ap-southeast-243dcf283-7e70-4594-9caa-30a16ce2b605
ap-southeast-1c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0d
ap-northeast-2b863c2bb-2b80-45d1-af82-1a3e152eaaa8
af-south-15cf09ba6-60be-4b5b-aaf9-61f7f3c0be9c

4. 选择提交

5. 查看在“工具状态”视图中自动填充的所有设置。确保工具状态按钮已设置为已批准

6. 在“机构策略”中,所有设置默认为已启用。我们建议您将所有设置保持为已启用状态,以防您的机构决定稍后使用更多设置。

7. 选择提交完成 LTI 1.3 注册。现在,Google 集成会在“管理员面板”的工具和实用程序类别下显示为一个选项 。

默认情况下,添加客户端 ID 会在 Learn 中配置不同的 Google 集成位置。

  • 内容大纲中的 Google LTI 链接
  • 管理员设置
  • Content Market 中的 Google LTI 链接

在 Learn 中启用 Google Workspace 集成

1. 在 Learn 中“管理员面板”的工具和实用程序下选择 Google 集成页面。

Image of the Administrator Panel in Learn, with the link for Google Integration highlighted at the bottom

2. 使用配置 Workspace 时从 Google Cloud 获取的信息填写所有必填字段。如果贵机构有两个 Google Workspace,请选择连接其他 Google Workspace 来输入第二个 Google Workspace 的信息。

所有学生都需要具有“学生”机构角色,才能访问教师添加到课程中的 Google 内容。

Google Integration page, showing the required fields for completing integration, with the Connect another Google Workspace button highlighted

3. 选择提交,为机构启用 Google Workspace 集成。