版本说明

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

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

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

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

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

2018 年 8 月 7 日：针对课业和学生提交内容的推送通知

  • 接收有关课程作业和学生提交的作业更改的实时通知。现在，您可以接收新发布的作业、学生上交的作业、教师给提交的作业评分等

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

  • 接收有关学生名单变动的实时通知 - 您可以使用 Google Cloud Pub/Sub 获取课程或网域的学生名单更新，而不是轮询 Google 课堂 API 端点来更新学生名单
  • 创建和更新通知 - 除了课程之外，应用现在还可以在课程信息流中创建和更新通知
  • 创建和更新仅针对个别学生的信息 - 应用现在可以选择向个别学生（而非全班学生）发布通知或课程

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

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

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

Classroom API 更新

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

更新了课程作业端点，以便应用：

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

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

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

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

  • 管理活跃的监护人

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

  • Google Apps Script 现已推出 Google 课堂 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 博客。