预览功能和路线图

本页面包含有关 Classroom API 即将推出的功能的信息，以及有关如何参与开发者预览版的详细信息。

预览 Classroom API

预览 Classroom API 功能可让开发者有机会通过反馈影响功能开发，并在正式发布之前准备好集成以供公开使用。

预览版生命周期

开发者可以选择使用包含新的向后兼容功能的 API 版本。这些“预览版”至少会公开发布 90 天。根据反馈，预览版及其功能随后会纳入现有的 v1 API 中。预览版在关闭前至少还会再提供 90 天。

如果预览版的反馈足够强烈，需要进行重大更改，则会创建一个新版本来支持现有功能。这两个版本至少会提供 90 天，以便开发者进行迁移。加入 Classroom API 开发者预览版邮寄名单，及时了解预览版变更；订阅公告名单，了解更常规的 Classroom API 更新。

参与 Classroom API 预览版计划

如需参与，请加入 Google Workspace 开发者预览版计划。如需查看可用的公开预览版功能，请参阅 Google Workspace 有效开发者预览版。如果您正在测试私密预览版功能，则可能不会在任何公开文档中看到该功能。

即将发布的功能

这是我们预期 API 特性和时间表的路线图。它会定期更新。

预览版值表示相应版本的初始预览版预计发布日期。如需了解如何使用预览版，请参阅访问预览版 API。

功能	说明	预览版的目标受众	适用于 GA 的目标	预览版本
用户功能	检查用户是否具有对特定 Google 课堂功能的访问权限。	2024 年第 4 季度	2025 年上半年	`V1_20240930_PREVIEW`
学生群组	代表管理员和教师管理学生群组及其成员。	2025 年第 3 季度	待定	待定

先前版本

新功能通过验证后，便会纳入 v1 API，并关闭相应的预览版。在预览版关闭之前，开发者至少有 90 天的时间进行迁移。

功能	说明	已纳入 Google Analytics	目标预览版关闭日期	预览版本
Rubrics CRUD	代表教师创建、读取、更新和删除 Google 课堂评分标准。	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 专用修订条款，方法是填写并提交此表单：