驗證學生資訊系統是否符合 Google Classroom 需求條件

如要將學生資訊系統與 Classroom 整合，請先驗證產品 想遵守 Classroom 的合作夥伴規定嗎？ 我們提供一組一致性測試。

存取並執行測試

您可以在 GitHub 上存取合規性測試。如要執行測試 需要下列項目：

• 擷取 OAuth 2.0 憑證的權杖網址
• 一個結尾為 /ims/oneroster/v1p1 的 Roster 網址
• 用戶端 ID
• 用戶端密碼
• 老師的電子郵件地址

測試套件分為三個部分：

• 基本成績同步處理
• 評分類別
• 評分期間

你可以使用 Google Colab 或 Jupyter 筆記本執行測試。兩個 Colab 以及 Jupyter 筆記本這種做法 測試結果 與 Google Classroom 團隊分享資訊。

學生資訊系統規定和預期行為

Google 定義的測試是為了維持一致性，盡量減少測試 使用者透過學生資訊系統整合時可能會遇到的錯誤 Classroom。請詳閱下列測試指標。於 GitHub，每項測試都有指標可參照的標題。注意事項 說明圖示能協助釐清問題，但不是完整清單 測試的重點確認您已執行 GitHub 提供的所有測試。

重要事項： 下表提供幾個指標，協助您進行整合 。根據一致性測試結果， 標準。

基本成績同步處理

測試	指標
老師：GetAllTeachers	系統會使用 limit 查詢參數呼叫 GET /teachers 端點。在後續測試中，這個參數會用於確保產品支援頁面大小為 10,000。
老師：具備電子郵件篩選器的 GetAllTeachers	系統會使用 filter 查詢參數呼叫 GET /teachers 端點，根據老師的電子郵件地址進行篩選。這項操作會使用您在測驗「憑證」部分提供的老師電子郵件地址。
課程：GetClassesForTeacher	系統會使用 filter 查詢參數呼叫 /teachers/{teacher_sourced_id}/classes 端點，並根據使用中的類別進行篩選。
學生：GetStudentsForClass	系統會呼叫 GET /classes/{class_sourced_id}/students 端點。必須在回覆中發還學生的電子郵件地址。
LineItem：建立	呼叫 PUT /lineItems/{line_item_sourced_id} 時不需要評分類別或評分期間。
委刊項：編輯	如果指派的工作標題長度過長，API 呼叫不應傳回錯誤。測試包含超過 100 個字元的作業標題。
結果：編輯	應該可將 score 設為大於 resultValueMax 的值，代表額外的功勞。
結果：刪除	必須提供 DELETE /results/{result_sourced_id} 端點。
委刊項 (選用 / 清除)：刪除和取得	不需要提供 DELETE /lineItems/{line_item_sourced_id} 端點。這是選用項目，用於清除資料。後面的 GET /classes/{class_sourced_id}/lineItems 端點也是選用端點，用來測試該委刊項是否已刪除。

評分類別

測試	指標
GetAllCategory 或 GetCategoriesForClass	只需要一個 GET /categories 端點，GetAllCategory 或 GetCategoriesForClass。如果同時執行所有測試，請註解排除目前不使用的程式。
刪除委刊項 (選用 / 清除)	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 認證 [e-mail].

取得支援

如有任何問題或疑問，請傳送電子郵件至 [e-mail]， 疑慮。