預覽功能與發展藍圖

本頁面提供 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 目標	預覽影片版本
評分週期	代表管理員和老師建立、讀取、更新及刪除評分期間。	2024 上半年	TBD	V1_20240401_PREVIEW
使用者功能	檢查使用者是否有權存取特定 Classroom 功能。	2024 年第 4 季	2025 上半年	V1_20240930_PREVIEW

舊版本

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

功能	說明	已納入 GA	目標預覽關閉日期	預覽影片版本
Rubrics CRUD	代表老師建立、讀取、更新及刪除課堂評量標準。	2024 年 12 月 5 日	2025 年 4 月 1 日	V1_20231110_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 專屬修訂條款：