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

若要将您的 SIS 与 Google 课堂集成，请运行我们提供的一系列一致性测试，验证您的产品是否符合 Google 课堂的合作伙伴关系要求。

访问并运行测试

您可以在 GitHub 上访问一致性测试。为了运行测试，您需要符合以下条件：

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

测试套件中有三个部分：

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

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

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

Google 定义的测试旨在保持一致性并最大限度地减少用户在将 SIS 与 Google 课堂集成时可能遇到的错误。仔细阅读以下测试指针。在 GitHub 中，每个测试都标有 @title。这些标题在指针中引用。

  1. 请注意关于基本成绩同步部分的以下事项：

    • 在 GetAllTeachers 测试中，使用 limit= 查询参数调用 GET /teachers 端点。在后续测试中，此参数用于确保您的产品可以支持 10,000 的页面大小。

    • 在 GetAllTeachers with email filter 测试中，系统使用 filter= 查询参数调用 GET /teachers 端点，该查询参数用于根据教师电子邮件地址进行过滤。运行测试时，您需要指定教师电子邮件地址。

    • 在 GetClassesForTeacher 测试中，使用 filter= 查询参数调用 /teachers/{teacher_sourced_id}/classes 端点，该参数用于根据活跃类进行过滤。

    • 在 GetStudentsForClass 测试中，调用了 GET /classes/{class_sourced_id}/students?limit=10000 端点。回复中必须返回学生的电子邮件地址。

    • 在 PutLineItem Create 测试中，调用 PUT /lineItems/{line_item_sourced_id} 时不需要成绩类别或评分周期。

    • 在 PutLineItem Edit 测试中，如果作业标题过长，API 调用不应返回错误。该测试包含一个长度超过 100 个字符的作业标题。

    • 在 PutResult Edit 测试中，应该可以将 score 设置为大于 resultValueMax 的值，以表示额外的功劳。

    • DELETE /results/{result_sourced_id} 端点是必需的，并且在 DeleteResult 测试中进行了测试。

    • DELETE /lineItems/{line_item_sourced_id} 端点不是必需项。这是可选操作，用于数据清理。

  2. 请注意有关成绩类别和评分周期部分的以下事项：

    • 只需要一个 GET /categories 端点。如果同时运行所有一致性测试，请注释掉不使用的测试：
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • 您可以通过在 GetAllClasses w/ filter 测试中检索 term_sourced_id 来测试评分周期支持。此 term_sourced_id 用于通过调用 GetGradingPeriodsForTerm 测试中的 GET terms/{term_sourced_id}/gradingPeriods?limit=10000 端点来检索相应术语的评分周期。

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

运行测试后，系统会生成包含每项测试结果的完整报告。这些测试用于确定您的产品是否符合 Google 的 OneRoster 1.1 消耗要求。下载生成的报告或截取屏幕截图通过电子邮件将报告和一个指向产品的 OneRoster 1.1 认证的链接发送至 classroom-sis-external@google.com。

获取支持

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