Google Classroom 支援多個符合 OneRoster 標準的學生資訊系統 (SIS),可同步處理成績單及匯入學生名單。Google 會與符合 Google 指定 OneRoster 要求的學生資訊系統平台合作。
與 Classroom 整合後,管理員就能將 Classroom 課程連結至貴機構的學生資訊系統。
圖 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 憑證的權杖網址
- One Roster 網址結尾為
/ims/oneroster/v1p1
- 用戶端 ID
- 用戶端密碼
- 老師的電子郵件地址
你可以使用 Google Colab 或 Jupyter 筆記本執行測試。Colab 和 Jupyter 筆記本都可讓你一次執行所有測試。這有助於產生測試結果,並與 Google Classroom 團隊分享。
SIS 規定和預期行為
Google 定義的測試可協助有興趣的 SIS 合作夥伴,判斷自家產品是否符合 Google 的 OneRoster 消耗量規定,並盡量減少使用者在 Classroom 中使用 SIS 整合功能時可能發生的錯誤。請詳閱下列測試重點。在 GitHub 中,每個測試都有指標參照的標題。請注意,這些指標可協助釐清問題,但並非完整的測試清單。請務必執行 GitHub 中提供的所有測試。
測試 | 指標 |
---|---|
老師:GetAllTeachers | 系統會使用 limit 查詢參數呼叫 GET /teachers 端點。在後續測試中,這個參數會用於確保產品可支援 10,000 的頁面大小。 |
老師:GetAllTeachers (電子郵件篩選器) | 系統會呼叫 GET /teachers 端點,並使用 filter 查詢參數,根據老師的電子郵件地址進行篩選。系統會使用您在測驗「憑證」部分提供的老師電子郵件地址。 |
課程: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:建立 | 呼叫 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。