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

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

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

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

要集成 Google Workspace，您需要：

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

在 Google Cloud 中配置 Google Workspace

您需要在 Google Cloud（也称为 Google 开发人员帐户）中配置您机构的设置。Google Cloud 位于 Learn 之外，必须使用您的 Google 的凭证来访问。按照链接的 PDF 在 Google Cloud 中配置 Google Workspace 中提供的步骤执行操作。该链接的 PDF 包含 Google Cloud 配置的工作示例。

使用此表可标识重定向 URI。您需要此 URI 来完成 Google Cloud 配置。

不同区域的客户端 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

您可以通过复制机构的 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 集成。