版本说明

本页面包含 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 课堂中阅读、撰写和修改 CourseWork Material 项：

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

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

2019 年 4 月 2 日：Classrooom 中的主题

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

2018 年 8 月 7 日：关于课程作业和学生提交的推送通知

  • 当课程作业和学生提交的作业发生更改时，您可以实时获取通知。现在，您可以监听新发布的作业、学生上交的作业、教师对提交内容进行评分等

2017 年 9 月 26 日：推送通知、公告和个性化帖子

  • 获取有关学生名单变化的实时通知 - 您可以使用 Google Cloud Pub/Sub 获取课程或网域的学生名单更新，而无需通过课堂 API 端点轮询更改情况
  • 创建和更新通知 - 除了课程作业之外，应用现在还可以在课程信息流中创建和更新通知
  • 创建和更新单独的帖子 - 应用现在可以选择向个别学生（而非全班）发布通知或课程作业

2017 年 8 月 1 日：转移课程所有权和提交历史记录

  • 使用管理员凭据更新课程的主要所有者 (ownerId)，或发起邀请让教师成为课程所有者
  • 访问学生提交的作业的提交记录

2017 年 6 月 19 日：安排课程作业、日历和已认证的教师

有关 Classroom API 的更新

2017 年 1 月 11 日：课程作业更新

通过更新 coursework 端点，应用能够：

  • 创建和更新问题
  • 修改和删除课程作业
  • 将云端硬盘内容和 YouTube 视频添加到课程作业和学生提交的作业中

2016 年 8 月 17 日：Classroom API 中的监护人

Google 课堂会生成针对学生活动的电子邮件摘要。Classroom API 支持监护人。开发者可以

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

  • 管理活跃的监护人

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

  • 现在可以在 Google Apps 脚本中使用 Google 课堂 API。不妨试用一下QuickStart。

2016 年 5 月 18 日：课堂 API 中新增了课程作业

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

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

Classroom API 现已面向所有开发者和 G Suite 教育版网域推出。您无需再请求访问权限即可开始使用 API。

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

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

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