您的用户是通过 Google Meet 使用 Google 课堂吗?请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况

概览

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Classroom API 提供了一个 RESTful 接口,供您在 Google 课堂中管理课程和学生名单。此外,借助“课堂”分享按钮,开发者和内容所有者还可以将内容分享到 Google 课堂。

哪些人可以使用该 API ?

G Suite 教育版网域管理员可以使用该 API 代表教师以编程方式配置课程,将学生信息系统与 Google 课堂同步,并大致了解自己网域中所授课程。

应用开发者可以使用 Classroom API 将其应用与 Google 课堂集成。这些应用需要使用 OAuth 2.0 来请求查看教师的课程和学生名单的权限。管理员可以限制网域中的教师和学生是否可以授权应用访问其 Google 课堂数据。

网站所有者和内容开发者可以使用“课堂”分享按钮,让学生和教师将内容分享回 Google 课堂。

所有 API 和 Google 课堂分享按钮集成均应遵循 Google 课堂品牌推广指南

API 概览

Classroom API 包含多种实体类型,它们分别对应于 Google 课堂界面中的课程、教师和学生。除了 Google 课堂中存在的属性外,这些实体中的一些实体还具备该 API 特有的其他属性。主要实体类型包括:

如需详细了解该 API 的资源和方法,请参阅 Classroom API 参考文档

课程元数据和别名

课程代表一个课程,例如“M. Smith 的第 4 节数学题及其指定的教师、学生名单和元数据。每门课程都由服务器分配的唯一 ID 进行标识。具体来说,课程资源封装了课程的所有元数据,例如名称、说明、地点和时间。通过 StudentTeacherInvitation 资源及其方法管理课程学生名单。

别名是类的备用标识符,可与课程关联,用于取代唯一 ID。每个别名都存在于一个命名空间中,命名空间限制了哪些人可以创建和查看该别名。支持两种命名空间:

  • 网域:网域命名空间用于创建所有用户需要访问但不特定于任何一个计划的别名。例如,课程的备用商家信息(例如 MATH 127 和 COMSCI 127)应在网域命名空间中创建。网域命名空间中的别名只能由网域管理员创建,但对网域中的所有用户可见。
  • 开发者项目:开发者项目命名空间可用于管理应用专用的别名。例如,为课程使用备用标识符的应用可以创建别名,以将其标识符映射到 Google 课堂课程。在此命名空间中创建的别名与特定 Google API 控制台相关联。应用的任何用户都可以在该应用的开发者项目的命名空间中创建和查看别名。

如需详细了解如何管理课程元数据和别名,请参阅管理课程

课程的学生名单和用户

“学生”和“教师”是用户个人资料与课程之间的具体对应关系,表示该用户在课程中的作用。指定学生和教师不属于全球范围:您可以将用户指定为一门课程的教师,将另一门课程中的学生指定为学生。“学生”或“教师”标识特定课程中特定用户的一组权限。

学生
学生资源代表已注册为特定课程的学生的用户。学生可以查看课程详情和课程的教师。
教师
教师资源表示讲授特定课程的用户。教师可以查看和更改课程详细信息,查看教师和学生,以及管理其他教师和学生。

邀请及其关联方法提供了一种将学生和教师添加到课程的便捷方式。创建邀请后,用户可以选择是否加入课程,而不是通过教师和学生资源直接进行添加。

UserProfiles 表示映射到用户的网域个人资料,如 Google Admin SDK 所返回的用户的唯一 ID 或电子邮件地址所标识。当前用户还可以使用 "me" 简写形式来引用自己的 ID。

如需详细了解如何管理学生名单,请参阅管理教师和学生

课程作业和学生提交的作业

CourseWork 项代表分配给一组学生的单个任务。它包含说明、截止日期、材质等详细信息以及创建时间等元数据。材料包括标题、缩略图和网址,以及可与相应 API(即云端硬盘、YouTube)搭配使用的标识符。

CourseWork 项描述的是以下任务类型之一:

  • 学生通过提交工作表或其他附件完成的作业。
  • 简答题或单选题。

CourseWork 项的学生作业由 StudentSubmission 表示。它由响应和额外的元数据(例如状态和分配的成绩)组成。

StudentSubmission 的内容取决于相应 CourseWork 项的类型:

  • 为作业提交的工作表和附件,包括标题、缩略图和网址,以及可与相应的 API(如云端硬盘或 YouTube)搭配使用的标识符。
  • 对简答题或单选题的回复。

如需详细了解如何管理课程作业和学生提交的作业,请参阅管理课业

开始

如需设置您的环境并立即开始使用该 API,请尝试以下某个快速入门:

您还可以浏览 API 参考文档