版本说明

本页面包含 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 课堂中读取、写入和修改课程作业资料项：

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 的更新

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。

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

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

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