Google 课堂支持与许多符合 OneRoster 标准的学生信息系统 (SIS) 同步成绩册和导入学生名单。Google 与符合 Google 指定的 OneRoster 要求的 SIS 平台合作。
与 Google 课堂合作后，管理员可以将 Google 课堂课程与您的 SIS 相关联。
图 1. 当学生信息系统 (SIS) 与 Google 课堂合作时，管理员可以在下拉菜单中选择 SIS。
SIS 合作伙伴发展历程
如果您有兴趣与 Google 课堂合作，请填写 意向表。
Google 课堂团队创建了一组一致性测试， 有兴趣的 SIS 合作伙伴可以使用这些测试来熟悉 Google 的 要求。您可以选择在与 Google 课堂团队联系之前运行一致性测试，以确定您的产品与 Google 的要求的符合程度。
获取开发者演示网域
您可能需要访问实时 Google 课堂实例，以构建和验证集成。符合条件的测试用户需要 Google Workspace 教育 Plus 版。如果您没有对具有这些许可的 Google Workspace 教育版网域的管理员 访问权限，请完成以下步骤以获取 开发者测试网域并 申请演示网域升级。您的网域将配置 10 个 Google Workspace 教育 Plus 版许可。
访问和运行测试
如需运行测试，您需要以下内容：
- 用于检索 OAuth 2.0 凭据的令牌网址
- 以
/ims/oneroster/v1p2结尾的 OneRoster 网址 - 客户 ID
- 客户端密钥
- 教师电子邮件地址
您可以使用 Google Colab 或 Jupyter 笔记本 运行测试。Colab 和 Jupyter 笔记本都允许您一次性运行所有测试。这有助于您生成 测试结果，以便与 Google 课堂团队分享。
SIS 要求和预期行为
Google 定义的测试旨在为有兴趣的 SIS 合作伙伴提供一种方法，以确定其产品是否符合 Google 的 OneRoster 使用要求，并最大限度地减少用户在 Google 课堂中使用 SIS 集成时可能遇到的错误。请仔细阅读以下有关测试的提示。在 GitHub 中，每个测试都有一个标题，这些标题会在提示中被引用。请注意，提示可以帮助您解答疑问，但它不是测试的完整列表。请确保您已运行 GitHub 中提供的所有测试。
| 测试 | 提示 |
|---|---|
| 教师：GetAllTeachers | 系统会使用 limit 查询参数调用 GET /teachers 端点。在后续测试中，此参数用于确保您的产品可以支持 10,000 的页面大小。 |
| 教师：GetAllTeachers（使用电子邮件过滤条件） | 系统会使用 filter 查询参数调用 GET /teachers 端点，该参数用于根据教师电子邮件地址进行过滤。这将使用您在测试的“凭据”部分中提供的教师电子邮件地址。 |
| 课程：GetClassesForTeacher | 系统会使用 filter 查询参数调用 /teachers/{teacher_sourced_id}/classes 端点，该参数用于根据活跃课程进行过滤。 |
| 学生：GetStudentsForClass | 系统会调用 GET /classes/{class_sourced_id}/students 端点。学生电子邮件必须在响应中返回。 |
| GetGradingPeriodsForTerm | 系统会使用 term_sourced_id 测试对评分期的支持。此 term_sourced_id 用于通过调用 GET terms/{term_sourced_id}/gradingPeriods 端点来检索学期中的评分期。 |
| LineItem：创建 | 调用 PUT /lineItems/{line_item_sourced_id} 时，不需要评分期。 |
| LineItem：修改 | 如果包含较长的作业标题，API 调用不应返回错误。该测试包含一个长度超过 100 个字符的作业标题。 |
| 结果：修改 | 应可以将 score 设置为大于 resultValueMax 的值，以表示额外加分。 |
| 结果：删除 | 需要 DELETE /results/{result_sourced_id} 端点。 |
| LineItem（可选 / 清理）：删除和获取 | 不需要 DELETE /lineItems/{line_item_sourced_id} 端点。它是可选的，用于数据清理。后续的 GET /classes/{class_sourced_id}/lineItems 端点也是可选的，用于测试是否已删除行项。 |
与 Google 课堂团队分享测试结果
运行测试后，系统会生成一份包含每个测试结果的完整报告。这些测试用于确定您的产品是否符合 Google 的 OneRoster 1.2 使用要求。请下载生成的报告或截取其屏幕截图，以便与 Google 课堂团队分享。
获取支持
如有任何疑问，请发送电子邮件至 classroom-sis-external@google.com。