如要將學生資訊系統與 Classroom 整合，請執行提供的相容性測試，驗證您的產品是否符合 Classroom 的合作夥伴規定。
存取及執行測試
您可以在 GitHub 上存取符合性測試。如要執行測試，您需要：
- 用於擷取 OAuth 2.0 憑證的權杖網址
- 結尾為
/ims/oneroster/v1p1的 OneRoster 網址 - 用戶端 ID
- 用戶端密碼
- 老師的電子郵件地址
測試套件分為三個部分：
- 基本成績同步處理
- 評分類別
- 評分週期
您可以使用 Google Colab 或 Jupyter 筆記本執行測試。您可以使用 Colab 和 Jupyter 筆記本一次執行所有測試。這有助於您產生測試結果，以便與 Google Classroom 團隊分享。
SIS 規定和預期行為
Google 定義的測試旨在維持一致性，並盡量減少使用者在使用 SIS 與 Classroom 整合時可能遇到的錯誤。請詳閱下列測試指引。在 GitHub 中，每項測試都有一個在指標中參照的標題。請注意，指標可以協助釐清問題，但並不是完整的測試清單。請務必執行 GitHub 提供的所有測試。
基本成績同步處理
| 測試 | 指標 |
|---|---|
| 老師：GetAllTeachers | 系統會使用 limit 查詢參數呼叫 GET /teachers 端點。在後續測試中，這個參數可確保產品可支援 10,000 個項目的頁面大小。 |
| 老師：使用電子郵件篩選器執行 GetAllTeachers | 系統會使用 filter 查詢參數呼叫 GET /teachers 端點，用於根據老師的電子郵件地址進行篩選。系統會使用您在測驗的「憑證」部分提供的教師電子郵件地址。 |
| 類別：GetClassesForTeacher | 呼叫 /teachers/{teacher_sourced_id}/classes 端點時，會使用 filter 查詢參數，用於根據有效類別進行篩選。 |
| 學生：GetStudentsForClass | 系統會呼叫 GET /classes/{class_sourced_id}/students 端點。必須在回覆中發還學生的電子郵件地址。 |
| LineItem：Create | 呼叫 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 端點也是選用端點，用來測試該委刊項是否已刪除。 |
評分類別
| 測試 | 指標 |
|---|---|
| GetAllCategories 或 GetCategoriesForClass | 您只需要一個 GET /categories 端點，可以是 GetAllCategories 或 GetCategoriesForClass。如果要一次執行所有測試，請將您不使用的測試註解掉。 |
| DeleteLineItem (選用 / 清理) | DeleteLineItem 測試為選用項目，可用於清除資料。 |
評分週期
| 測試 | 指標 |
|---|---|
| GetGradingPeriodsForTerm | 使用篩選器測試在 GetAllClasses 中擷取 term_sourced_id，即可測試評分期間支援。這個 term_sourced_id 會在 GetGradingPeriodsForTerm 測試中呼叫 GET terms/{term_sourced_id}/gradingPeriods 端點，用於擷取學期中的評分期間。 |
將測試結果提供給 Google Classroom 團隊
執行測試後，系統會產生一份包含每個測試結果的完整報告。這些測試可用於判斷您的產品是否符合 Google 的 OneRoster 1.1 使用規定。下載或擷取產生的報表請將報告和產品的 OneRoster 1.1 認證連結，透過電子郵件寄到 classroom-sis-external@google.com。
取得支援
如有任何問題或疑慮，請傳送電子郵件至 classroom-sis-external@google.com。