前提条件

所有 Google Workspace 集成都依赖于 Google Cloud 来配置 API 访问权限、处理身份验证和授权,以及管理应用。您可能还需要获得 Google 课堂的访问权限,才能测试集成。本指南介绍了如何请求和配置这些资源。

设置 Google Cloud 项目

完成适用于 Google Workspace 开发者的开始使用步骤。所有 Google Workspace 集成都必须执行以下步骤。

测试账号和网域

演示网域是 Google 课堂 API 集成的测试账号。演示版网域代表一个订阅了 Google Workspace 教育版的虚构学校,您可以使用该网域开发和测试集成,而不会影响真实用户。

您可以获取测试网域,以便测试管理员功能或使用 Classroom API 进行开发。

获取管理员测试网域

如果您只需测试 API 的管理员权限,则可以使用预构建的演示环境。例如,代表教师创建课程。

如需使用预构建环境,请加入 Google Cloud Partner Advantage 计划。会员可以访问 Partner Advantage 的 Google for Education 页面。本页介绍了如何访问预构建的 Google Workspace 教育版演示环境,该环境可用于客户演示、产品问题排查、功能测试等。

获取开发者演示域名

如需代表教师和学生用户提出请求,您需要创建并管理自己的 Google Workspace 教育版演示版网域。演示网域包含永久有效的免费 Google Workspace 教育基础版许可。您可以根据需要向网域添加更多商品。

请完成以下步骤,获取开发者演示网域。

  1. 购买格式为 gedu.demo.YOUR DOMAIN 的域名。例如,运营域名 myedtech.com 的组织应创建 gedu.demo.myedtech.com。演示网域必须遵循此格式。
  2. 验证您对该演示版网域的所有权。
  3. 使用演示版网域注册 Google Workspace 教育版。这将开始为期两周的试用期。

  4. 请填写此表单,告知 Google 您已注册域名。 所有演示网域请求都将由合作伙伴经理进行审核。

  5. 如果您正在开发的集成会使用付费 Google 课堂功能,请申请升级演示版网域

  6. 使用您在注册 Google Workspace 教育版时指定的管理员账号登录 Google 管理控制台。接下来,创建新的演示网域用户;我们建议您至少再创建 3 位用户:1 位教师和 2 位学生。

  7. 使用新的教师账号登录 Google 课堂classroom-site创建新课程,并向其中添加新的学生账号

请求升级演示版域名以使用高级功能

用户必须拥有适当的 Google Workspace 教育版许可,才能使用会影响或依赖于高级 Google 课堂功能的集成。相关功能包括:

  • Google 课堂插件
  • 评分周期
  • 评分标准
  • 成绩导出
  • 学生名单同步
  • 评分准则

如需查看各个订阅级别提供的功能的完整列表,请参阅 Google Workspace 教育版许可页面。

如果您的集成将使用上述任一功能,请完成以下步骤以请求升级演示网域。升级后的网域将获得 10 个免费的 Google Workspace 教育 Plus 版许可,供您分配给测试用户。

  1. 如果您尚未获取开发者演示版网域,请完成相应步骤。
  2. 填写并提交演示网域升级申请表单。提交此表单即表示您请求 Google 将您的演示网域升级为 Google Workspace 教育 Plus 版,并提供 10 个许可。
  3. 升级流程完成后,您会收到一封电子邮件。
  4. 在升级后的演示版网域的管理控制台中,为您的测试教师账号分配 Plus 许可。
    1. 目录 > 用户下,创建或选择测试教师账号。
    2. 在每位教师的许可中,确认 Google Workspace 教育 Plus 版已分配