验证您的学生信息系统是否符合 Google 课堂要求

要将您的学生信息系统 (SIS) 与 Google 课堂集成，请验证您的产品 通过运行 提供了一组一致性测试。

访问并运行测试

您可以在 GitHub 上访问一致性测试。为了运行测试， 需要以下内容：

  • 用于检索 OAuth 2.0 凭据的令牌网址
  • 以 /ims/oneroster/v1p1 结尾的 OneRoster 网址
  • 客户端 ID
  • 客户端密钥
  • 教师电子邮件地址

测试套件包含三个部分：

  • 基本成绩同步
  • 评分类别
  • 评分周期

您可以使用 Google Colab 或 Jupyter 笔记本运行测试。Colab 和 Jupyter Notebook 让你可以同时运行所有测试。这有助于您生成 将测试结果 与 Google 课堂团队分享。

学生信息系统要求和预期行为

Google 定义的测试旨在保持一致性并最大限度地减少 用户在使用学生信息系统 (SIS) 集成 课堂。请仔细阅读以下测试要点。在 GitHub 上，每个测试都有一个在指针中引用的标题。注意事项 提供的指针有助于阐明问题，但并不是一个全面的列表 部分测试。确保您已运行 GitHub 中提供的所有测试。

基本成绩同步

测试 指针
教师：GetAllTeachers GET /teachers 端点是使用 limit 查询参数调用的。在后续测试中，此参数用于确保您的商品可以支持大小为 10,000 的页面。
教师：使用电子邮件过滤器的 GetAllTeachers 系统使用 filter 查询参数调用 GET /teachers 端点，该参数用于根据教师的电子邮件地址进行过滤。这将使用您在测试的“凭据”部分提供的教师电子邮件地址。
类：GetClassesForTeacher 使用 filter 查询参数调用 /teachers/{teacher_sourced_id}/classes 端点，该参数用于根据活跃类进行过滤。
学生：GetStudentsForClass 调用 GET /classes/{class_sourced_id}/students 端点。必须在回复中返回学生电子邮件地址。
订单项：创建 调用 PUT /lineItems/{line_item_sourced_id} 时，无需设置评分类别或评分周期。
订单项：修改 如果分配的标题长度较长，API 调用不应返回错误。此测试包括一个长度超过 100 个字符的作业标题。
结果：修改 应该能够将 score 设置为大于 resultValueMax 的值，以表示额外的功劳。
结果：删除 DELETE /results/{result_sourced_id} 端点为必填项。
订单项（可选 / 清理）：删除和获取 DELETE /lineItems/{line_item_sourced_id} 端点不是必需的。此为可选操作，用于数据清理。后面的 GET /classes/{class_sourced_id}/lineItems 端点也是可选的，用于测试订单项是否已被删除。

评分类别

测试 指针
GetAllCategories 或 GetCategoriesForClass 只需要一个 GET /categories 端点，即 GetAllCategories 或 GetCategoriesForClass。如果同时运行所有测试，请注释掉不用的测试。
DeleteLineItem（可选 / 清理） DeleteLineItem 测试为可选项，可用于数据清理。

评分周期

测试 指针
GetGradingPeriodsForTerm 如需测试评分周期支持情况，请使用过滤器测试在 GetAllClasses 中检索 term_sourced_id。此 term_sourced_id 用于通过在 GetGradingPeriodsForTerm 测试中调用 GET terms/{term_sourced_id}/gradingPeriods 端点来检索学期中的评分周期。

与 Google 课堂团队分享测试结果

运行测试后，您会看到一份包含每次测试的结果的完整报告 。这些测试用于确定您的商品是否符合 Google 的 OneRoster 1.1 用量要求。下载或截屏 生成的报告通过电子邮件发送报告和产品链接 OneRoster 1.1 认证 classroom-sis-external@google.com.

获取支持

如有任何疑问，请发送电子邮件至 classroom-sis-external@google.com 或 问题。

上一页
开始