版本说明

本页面包含 Classroom API 的版本说明。订阅公告列表即可接收电子邮件更新。

2023 年 11 月 13 日：开发者预览版：评分标准 CRUD

评分标准 CRUD 作为 Google Workspace 开发者预览版计划的一部分提供，该计划可让您抢先体验某些功能。借助此功能，开发者可以代表教师管理 Google 课堂评分标准。如需详细了解如何参与预览版功能，请参阅路线图。

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 日：Google 课堂资料

开发者现在可以在 Google 课堂中读取、写入和修改课程作业资料项：

• 创建 CourseWorkMaterials
• 检索一个或所有 CourseWorkMaterial
• 更新 CourseWorkMaterials
• 修改 CourseWorkMaterials 的附件
• 删除 CourseWorkMaterials

2019 年 11 月 18 日：新的分享按钮网址参数

• 在向 Google 课堂分享内容时，为课程 ID 和资料类型设置分享标记属性。

2019 年 4 月 2 日：Google 课堂中的主题

• 检索、创建、修改和删除 Google 课堂中的主题 - 现在，您可以通过 API 在 Google 课堂中整理和检索课业项目。

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 API 支持监护人。开发者可以

• 邀请个人成为监护人
• 检索学生的受邀监护人和有效监护人

• 管理有效监护人

• G Suite 教育版管理员应确认其“Google 课堂”数据访问权限设置是否正确。

• Google Apps Script 现已支持 Classroom API。不妨试试QuickStart。

2016 年 5 月 18 日：作业已添加到 Classroom API

Classroom API 现在包含课程作业，即作业、题目、学生回答和成绩。请参阅课程作业指南以开始使用。

2015 年 8 月 8 日：Classroom API 现已正式发布

Google 课堂 API 现已面向所有开发者和 G Suite 教育版网域开放。您不再需要申请访问权限即可开始使用该 API。

• G Suite 教育版管理员应确认其“Google 课堂”数据访问权限设置是否正确。
• Google Apps Script 现已支持 Classroom API。不妨试试QuickStart。

2015 年 6 月 29 日：Classroom API 现已推出开发者预览版

Classroom API 现已推出开发者预览版。您现在可以注册抢先体验和测试账号。

• G Suite 教育版管理员如果想让其网域中的用户提前访问该 API，可以注册网域白名单。
• 开发者可以申请抢先体验使用该 API 的代码。

如需查看完整公告，请参阅 Google for Education 博客。