Google Classroom 支援多個符合 OneRoster 標準的學生資訊系統 (SIS) 同步成績單和學生名單匯入功能。Google 與符合 Google 指定 OneRoster 規定的學生資訊系統平台合作。
與 Classroom 合作後，系統管理員就能將 Classroom 課程連結至 SIS。
圖 1. 學生資訊系統 (SIS) 與 Classroom 合作後，系統管理員可以在下拉式選單中選擇 SIS。
學生資訊系統合作夥伴開發歷程
如果您有意與 Classroom 合作，請填寫意願調查表。
Classroom 團隊已建立一組相容性測試，有興趣的學生資訊系統合作夥伴可以使用這些測試來熟悉 Google 的規定。您可以先執行符合性測試，再與 Classroom 團隊聯絡，瞭解產品符合 Google 要求的程度。
取得開發人員示範網域
您可能需要存取實際的 Google Classroom 執行個體，才能建立及驗證整合作業。符合資格的測試使用者必須使用 Google Workspace for Education Plus 版。如果您沒有 Google Workspace for Education 網域的管理員存取權，且該網域已取得這些授權，請完成取得開發人員測試網域的步驟，並要求升級示範網域。您的網域將配給 10 個 Google Workspace for Education Plus 授權。
存取及執行測試
如要執行測試，您需要：
- 用於擷取 OAuth 2.0 憑證的符記網址
- 結尾為
/ims/oneroster/v1p1的 OneRoster 網址 - 用戶端 ID
- 用戶端密碼
- 老師的電子郵件地址
您可以使用 Google Colab 或 Jupyter 筆記本執行測試。Colab 和 Jupyter 筆記本都允許您一次執行所有測試。這有助於您產生測試結果，以便與 Google Classroom 團隊分享。
SIS 規定和預期行為
Google 定義的測試可讓有興趣的 SIS 合作夥伴判斷產品是否符合 Google 的 OneRoster 使用需求，並盡量減少使用者在 Classroom 中使用 SIS 整合功能時可能遇到的錯誤。請詳閱下列測試相關提示。在 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 端點。回應中必須傳回學生的電子郵件地址。 |
| GetGradingPeriodsForTerm | 評分期間支援功能會使用 term_sourced_id 進行測試。這個 term_sourced_id 會呼叫 GET terms/{term_sourced_id}/gradingPeriods 端點，藉此擷取學期中的評分期間。 |
| 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 端點也是選用項目，可用於測試委刊項是否已刪除。 |
將測試結果提供給 Google Classroom 團隊
執行測試後，系統會產生包含每項測試結果的完整報告。這些測試可用於判斷您的產品是否符合 Google 的 OneRoster 1.2 使用量規定。下載產生的報表或擷取螢幕畫面，然後與 Google Classroom 團隊分享。
取得支援
如有任何疑問，請傳送電子郵件至 classroom-sis-external@google.com。