預覽功能與發展藍圖
透過集合功能整理內容你可以依據偏好儲存及分類內容。

本頁面提供 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`

舊版本

新功能經過驗證後，就會整合至 v1 API，而對應的預覽版也會關閉。開發人員至少有 90 天的時間，可以在預覽版關閉前完成遷移。

功能	說明	已納入 GA	目標預覽關閉日期	預覽影片版本
Rubrics CRUD	代表老師建立、讀取、更新及刪除課堂評量標準。	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 GA 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 開發人員預先發布版計畫條款的 Classroom 專屬修訂條款：