Google Classroom 支援匯入學生名單，以及同步多個符合 OneRoster 標準的學生資訊系統 (SIS) 成績單。Google 合作夥伴的學生資訊系統平台，必須符合 Google 指定的 OneRoster 規定。
圖 1. 如果學生資訊系統 (SIS) 與 Classroom 合作，管理員就能在下拉式選單中選擇 SIS。
學生資訊系統合作夥伴新手上路流程
以下是 SIS 合作夥伴新手上路流程的簡要說明：
表達意願：如有意與 Classroom 合作，請填寫意願調查表。
探索並執行相容性測試：如要瞭解 SIS 是否已準備好與 Classroom 整合，請查看相容性測試，熟悉 Google 的要求。您可以先執行一致性測試，判斷產品與 Google 規定的符合程度，再向 Google Classroom 團隊表達意願。
與 Google Classroom 團隊聯絡： 提交意願調查表後，Classroom 團隊會與您聯絡，討論合作機會。
分享測試結果並建構端對端整合：Classroom 團隊與您聯絡後，請分享一致性測試結果。您的團隊將與 Google 合作，驗證並完成整合。
一致性測試
Google 定義的一致性測試可讓 SIS 合作夥伴判斷產品是否符合 Google 的 OneRoster 消耗需求，並盡可能減少使用者在 Classroom 中使用 SIS 整合功能時可能遇到的錯誤。測試會發布在 GitHub 上。
存取並執行測試
如要執行測試，您需要：
- 用於擷取 OAuth 2.0 憑證的權杖網址
- OneRoster 網址結尾為
/ims/oneroster/v1p2 - 用戶端 ID
- 用戶端密鑰
- 老師的電子郵件地址
您可以使用 Google Colab 或 Jupyter 筆記本執行測試。Colab 和 Jupyter 筆記本都可讓您一次執行所有測試。這有助於產生測試結果，與 Google Classroom 團隊分享。
規定和預期行為
請詳閱下列測試重點。在 GitHub 中，每項測試都有一個標題，表格中會參照這個標題。這些提示有助於釐清問題，但並未列出所有測試。請務必執行 GitHub 提供的所有測試，確保符合規範。
| 測試 | 指標 |
|---|---|
| 老師：GetAllTeachers | 系統會使用 limit 查詢參數呼叫 GET /teachers 端點。在後續測試中，這項參數會用來確保產品可支援 10,000 的頁面大小。 |
| 老師：GetAllTeachers (使用電子郵件篩選器) | 呼叫 GET /teachers 端點時，會使用 filter 查詢參數，根據老師的電子郵件地址進行篩選。系統會使用您在測驗「憑證」部分提供的老師電子郵件地址。 |
| 課程：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: Create | 呼叫 PUT /lineItems/{line_item_sourced_id} 時，不一定要提供評分週期。 |
| LineItem: Edit | 如果包含長作業標題，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 團隊的聯絡人分享。
取得開發人員示範網域
Google Classroom 團隊審查完一致性測試結果後，您可以使用開發人員試用網域，驗證端對端整合。請注意，即使成功通過一致性測試，也不保證能獲得合作夥伴關係或整合核准。
開發人員試用網域是 Google Classroom 的即時測試環境，可協助您驗證整合功能是否正常運作。請按照步驟取得開發人員試用網域，並申請升級試用網域。升級後，網域會獲得 10 個 Google Workspace for Education Plus 授權。您必須將這些授權指派給開發人員網域中的測試使用者，他們才能在 Classroom 中測試學生資訊系統整合功能。
常見問題
1. Classroom 預期學生資訊系統提供什麼資料模型？
Classroom 遵循 OneRoster 1.2 規格。 如果學生資訊系統使用不同的資料結構，可能會發生非預期的行為。舉例來說，如果系統支援評分週期和成績類別之間的巢狀關係，這就超出 OneRoster 1.2 規格，您應徹底測試整合，確保相容性。
2. 哪些成績和作業狀態會匯出至學生資訊系統？
只有已發還的成績，或是標示為「缺交」或「已免除」的作業，才會匯出至學生資訊系統。暫定成績不會匯出。
3. 如果在 Classroom 刪除作業，學生資訊系統中的明細項目會受到什麼影響？
在 Classroom 中刪除作業，並不會刪除學生資訊系統中的對應明細項目。這可防止意外遺失資料和非預期的串聯刪除。