版本資訊

本頁面提供 Classroom API 的版本資訊。訂閱公告清單，接收電子郵件最新消息。

2023 年 11 月 13 日：開發人員預先發布版：CRUD 評量表

評量表 CRUD 屬於 Google Workspace 開發人員預先發布計畫的一部分，可搶先體驗特定功能。這項功能可讓開發人員代表老師管理 Classroom 評量表。如要進一步瞭解如何參與預先發布功能，請參閱路線圖。

2023 年 6 月 26 日：受邀使用者不會造成中斷的錯誤碼異動

如果受邀使用者 (已受邀加入課程但尚未接受邀請的老師或學生) 提出要求，下列端點現在會傳回 404 錯誤。先前這些端點會傳回 403 錯誤：

• courses.courseWork.create
• courses.courseWork.delete
• courses.courseWork.get
• courses.courseWork.patch
• courses.courseWorkMaterials.create
• courses.courseWorkMaterials.delete
• courses.courseWorkMaterials.get
• courses.courseWorkMaterials.patch
• courses.announcements.create
• courses.announcements.delete
• courses.announcements.get
• courses.announcements.patch

下列相關端點不受影響：

• courses.courseWork.list
• courses.courseWork.modifyAssignees
• courses.courseWorkMaterials.list
• courses.announcements.list
• courses.announcements.modifyAssignees

2022 年 8 月 8 日：成績類別和成績單設定

現在可以使用 API 擷取作業的成績類別，以及課程的成績單設定。

2020 年 9 月 21 日：Classroom Materials

開發人員現在可以在 Classroom 中讀取、寫入及修改 CourseWork Material 項目：

• 建立 CourseWorkMaterials
• 擷取一項或所有 CourseWorkMaterials
• 更新 CourseWorkMaterials
• 修改 CourseWorkMaterials 的附件
• Delete CourseWorkMaterials

2019 年 11 月 18 日：新的分享按鈕網址參數

• 將內容分享至 Classroom 時，請為課程 ID 和教材類型設定分享標記屬性。

2019 年 4 月 2 日：Classroom 主題

• 擷取、 建立、 編輯、 以及刪除 Classroom 中的主題 - 現在您可以使用 API 整理及擷取 Classroom 中的作業項目。

2018 年 8 月 7 日：課程作業和學生繳交作業的推播通知

• 即時接收通知，掌握課程作業和學生繳交內容的變更情況。現在，你可以聆聽新發布的作業、學生繳交的內容、老師評分的內容等

2017 年 9 月 26 日：推播通知、公告和個人化貼文

• 接收學生名單異動的即時通知：您可以使用 Google Cloud Pub/Sub 取得課程或網域的學生名單更新，不必輪詢 Classroom API 端點的異動
• 建立及更新公告：除了課程作業，應用程式現在還可以在課程訊息串中建立及更新公告
• 建立及更新個人化訊息：應用程式現在可以針對個別學生發布公告或指派課堂作業，不必再發布給全班

2017 年 8 月 1 日：轉移課程擁有權和提交記錄

• 使用管理員憑證更新課程的主要擁有者 (ownerId)，或邀請老師成為課程擁有者
• 存取學生提交內容的繳交記錄

2017 年 6 月 19 日：安排課程、日曆和已驗證的老師

Classroom API 更新

• 預定課程出作業的時間：做法是在課程作業的 [scheduledTime] 欄位設定未來的日期/時間，系統就會於指定時間出作業
• 存取課程的 calendarId
• 判斷特定使用者是否為已通過驗證的老師

2017 年 1 月 11 日：課程更新

更新 coursework 端點後，應用程式就能：

• 建立及更新問題
• 修改及刪除作業
• 在課程作業和學生提交內容中新增雲端硬碟項目和 YouTube 影片

2016 年 8 月 17 日：Classroom API 中的監護人

Google Classroom 會為監護人產生學生活動的電子郵件摘要，Classroom API 支援監護人。開發人員可以

• 邀請他人擔任監護人
• 擷取學生的受邀和現任監護人

• 管理目前的位置資訊分享對象

• G Suite 教育版管理員應確認Classroom 資料存取設定正確無誤。

• Google 應用程式指令碼現已支援 Classroom API。請嘗試QuickStart。

2016 年 5 月 18 日：Classroom API 新增作業功能

Classroom API 現在包含課程作業，也就是作業、問題、學生回覆和成績。如要開始使用，請參閱作業指南。

2015 年 8 月 8 日：Classroom API 現已正式發布

Classroom API 現已開放所有開發人員和 G Suite 教育版網域使用。您不必再申請存取權，即可開始使用 API。

• G Suite 教育版管理員應確認Classroom 資料存取設定正確無誤。
• Google 應用程式指令碼現已支援 Classroom API。請嘗試QuickStart。

2015 年 6 月 29 日：Classroom API 開放開發人員預覽版

Classroom API 現已開放開發人員預覽。歡迎立即註冊搶先體驗並取得測試帳戶。

• 如果 G Suite 教育版管理員想讓網域中的使用者搶先存取 API，可以申請將網域加入許可清單。
• 開發人員可以申請搶先存取 API，

如需完整公告，請參閱 Google for Education 網誌。