預覽功能與發展藍圖

本頁面提供 Classroom API 即將推出的功能資訊，以及如何參與開發人員預先發布計畫的詳細資料。

試用 Classroom API

開發人員可透過預先發布版搶先試用 Classroom API 功能，並提供意見回饋，進而影響功能開發方向，還能在正式發布前準備好整合功能，供大眾使用。

預覽生命週期

開發人員可以選擇採用包含新功能且可回溯相容的 API 版本。這些「預先發布版本」會公開發布至少 90 天。我們會根據意見回饋，將預覽版及其功能併入現有的 v1 API。預覽版至少還會提供 90 天，之後才會停用。

如果預先發布版本的意見回饋強烈要求破壞性變更，系統會建立新版本來支援現有功能。這兩個版本都會提供至少 90 天，方便開發人員遷移。加入 Classroom API 開發人員搶先體驗計畫郵寄清單，隨時掌握搶先體驗計畫的變更內容，並訂閱公告清單，接收 Classroom API 的一般更新資訊。

參與 Classroom API 搶先體驗計畫

如要參與，請加入 Google Workspace 開發人員預覽版計畫。如要查看公開測試版提供的功能，請參閱 Google Workspace 開發人員預先發布版。如果您正在測試私人搶先版功能，可能不會在任何公開文件中看到該功能。

即將推出的新功能

這份藍圖列出預計推出的 API 功能和時間表。系統會定期更新。

預覽版值代表該版本預計的初始預覽版推出日期。如要瞭解如何使用預先發布版本，請參閱「存取預先發布版 API」。

功能	說明	預先發布版目標	Google Analytics 目標	預覽影片版本
使用者功能	檢查使用者是否能存取特定 Classroom 功能。	2024 年第 4 季	2025 上半年	`V1_20240930_PREVIEW`
學生群組	代表管理員和老師管理學生群組和成員。	2025 年第 3 季	待定	待定

舊版本

新功能通過驗證後，就會併入 v1 API，並關閉對應的預覽版。預覽版關閉前，開發人員至少有 90 天的時間可進行遷移。

功能	說明	併入 Google Analytics	目標預覽版終止日期	預覽影片版本
Rubrics CRUD	代表老師建立、讀取、更新及刪除 Classroom 評量規準。	2024 年 12 月 5 日	2025 年 4 月 1 日	`V1_20231110_PREVIEW`
評分週期	代表管理員和老師建立、讀取、更新及刪除評分週期。	2025 年 4 月 8 日	2025 年 8 月 1 日	`V1_20240401_PREVIEW`

遷移指南

將預先發布版本的功能併入 v1 API 後，請從相關 API 呼叫中移除 previewVersion 引數，確保應用程式繼續正常運作。舉例來說，如果您要存取 V1_20231110_PREVIEW 版本推出的評量表建立功能，API 呼叫可能如下所示：

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        # Specify the preview version. Rubrics CRUD capabilities are
        # supported in V1_20231110_PREVIEW and later.
        previewVersion="V1_20231110_PREVIEW"
        ).execute()

如要遷移至 v1 正式發布版 API，請移除 previewVersion 引數：

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

如果您使用靜態產生的用戶端程式庫，專門存取特定預覽版功能，且未使用其他預覽版 API 功能，請改用您語言的預設用戶端程式庫。詳情請參閱「存取預先發布版 API」。

意見回饋

如要針對預覽功能提供意見，請前往 Google Workspace 開發人員預覽版計畫總覽頁面的「有效開發人員預覽版」部分，點選連結的 IssueTracker。

在正式環境中使用 Classroom API 預先發布版功能

如要與使用者 (包括任何實際的老師、管理員或學生) 一起使用 Classroom API 搶先版功能，您必須填寫並提交這份表單，同意 Google Workspace Developer Preview Program 條款的 Classroom 專屬修正條款：