Google Classroom API

管理 Google 课堂中的课程、学生名单和邀请。

服务:classroom.googleapis.com

如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://classroom.googleapis.com

REST 资源:v1.courses

方法
checkAddOnCreationEligibility
(deprecated)
GET /v1/courses/{courseId}:checkAddOnCreationEligibility
返回用户是否有资格在指定课程中创建插件附件。
checkGradingPeriodsSetupEligibility
(deprecated)
GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
返回用户是否有权更新给定课程中的 GradingPeriodSettings。
create POST /v1/courses
创建课程。
delete DELETE /v1/courses/{id}
删除课程。
get GET /v1/courses/{id}
返回课程。
getGradingPeriodSettings GET /v1/courses/{courseId}/gradingPeriodSettings
返回课程中的评分周期设置。
list GET /v1/courses
返回请求用户有权查看的课程列表,仅限与请求匹配的课程。
patch PATCH /v1/courses/{id}
更新课程中的一个或多个字段。
update PUT /v1/courses/{id}
更新课程。
updateGradingPeriodSettings PATCH /v1/courses/{courseId}/gradingPeriodSettings
更新课程的评分周期设置。

REST 资源:v1.courses.aliases

方法
create POST /v1/courses/{courseId}/aliases
为课程创建别名。
delete DELETE /v1/courses/{courseId}/aliases/{alias}
删除课程的别名。
list GET /v1/courses/{courseId}/aliases
返回课程的别名列表。

REST 资源:v1.courses.announcements

方法
create POST /v1/courses/{courseId}/announcements
创建通知。
delete DELETE /v1/courses/{courseId}/announcements/{id}
删除通知。
get GET /v1/courses/{courseId}/announcements/{id}
Returns an announcement.
getAddOnContext GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext
获取特定帖子上下文中 Google 课堂插件的元数据。
list GET /v1/courses/{courseId}/announcements
Returns a list of announcements that the requester is permitted to view.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
修改通知的分配者模式和选项。
patch PATCH /v1/courses/{courseId}/announcements/{id}
更新通告的一个或多个字段。

REST 资源:v1.courses.announcements.addOnAttachments

方法
create POST /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
在帖子下方创建插件附件。
delete DELETE /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
删除插件附件。
get GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
Returns an add-on attachment.
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
返回帖子下由插件创建的所有附件。
patch PATCH /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
更新插件附件。

REST 资源:v1.courses.courseWork

方法
create POST /v1/courses/{courseId}/courseWork
创建课程作业。
delete DELETE /v1/courses/{courseId}/courseWork/{id}
删除课业。
get GET /v1/courses/{courseId}/courseWork/{id}
Returns course work.
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
获取特定帖子上下文中 Google 课堂插件的元数据。
list GET /v1/courses/{courseId}/courseWork
返回请求者有权查看的课业列表。
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
修改课程的作业分配者模式和选项。
patch PATCH /v1/courses/{courseId}/courseWork/{id}
更新课业的一个或多个字段。

REST 资源:v1.courses.courseWork.addOnAttachments

方法
create POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
在帖子下方创建插件附件。
delete DELETE /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
删除插件附件。
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
Returns an add-on attachment.
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
返回帖子下由插件创建的所有附件。
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
更新插件附件。

REST 资源:v1.courses.courseWork.addOnAttachments.studentSubmissions

方法
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
返回学生提交的插件附件。
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
更新与插件附件提交相关联的数据。

REST 资源:v1.courses.courseWork.rubrics

方法
create POST /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
创建评分准则。
delete DELETE /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
删除评分准则。
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
返回评分准则。
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
返回请求者有权查看的评分标准列表。
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
更新评分准则。

REST 资源:v1.courses.courseWork.studentSubmissions

方法
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Returns a student submission.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
返回请求者有权查看的学生提交内容列表,并考虑请求的 OAuth 范围。
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
修改学生提交的作业的附件。
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
更新学生提交内容的一个或多个字段。
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
代表拥有相应提交内容的学生重新声明所有权。
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Returns a student submission.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
提交学生提交的内容。

REST 资源:v1.courses.courseWorkMaterials

方法
create POST /v1/courses/{courseId}/courseWorkMaterials
创建课程作业资料。
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
删除课业材料。
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
Returns a course work material.
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
获取特定帖子上下文中 Google 课堂插件的元数据。
list GET /v1/courses/{courseId}/courseWorkMaterials
返回请求者有权查看的课业材料列表。
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
更新课程作业材料的一个或多个字段。

REST 资源:v1.courses.courseWorkMaterials.addOnAttachments

方法
create POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
在帖子下方创建插件附件。
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
删除插件附件。
get GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
Returns an add-on attachment.
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
返回帖子下由插件创建的所有附件。
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
更新插件附件。

REST 资源:v1.courses.posts

方法
getAddOnContext GET /v1/courses/{courseId}/posts/{postId}/addOnContext
获取特定帖子上下文中 Google 课堂插件的元数据。

REST 资源:v1.courses.posts.addOnAttachments

方法
create POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments
在帖子下方创建插件附件。
delete DELETE /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
删除插件附件。
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
Returns an add-on attachment.
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
返回帖子下由插件创建的所有附件。
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
更新插件附件。

REST 资源:v1.courses.posts.addOnAttachments.studentSubmissions

方法
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
返回学生提交的插件附件。
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
更新与插件附件提交相关联的数据。

REST 资源:v1.courses.students

方法
create POST /v1/courses/{courseId}/students
将用户添加为课程的学生。
delete DELETE /v1/courses/{courseId}/students/{userId}
删除课程的学生。
get GET /v1/courses/{courseId}/students/{userId}
Returns a student of a course.
list GET /v1/courses/{courseId}/students
返回请求者有权查看的此课程的学生列表。

REST 资源:v1.courses.teachers

方法
create POST /v1/courses/{courseId}/teachers
创建课程的教师。
delete DELETE /v1/courses/{courseId}/teachers/{userId}
从指定的课程中移除指定的教师。
get GET /v1/courses/{courseId}/teachers/{userId}
返回课程的教师。
list GET /v1/courses/{courseId}/teachers
返回请求者有权查看的此课程的教师列表。

REST 资源:v1.courses.topics

方法
create POST /v1/courses/{courseId}/topics
创建主题。
delete DELETE /v1/courses/{courseId}/topics/{id}
删除主题。
get GET /v1/courses/{courseId}/topics/{id}
返回一个主题。
list GET /v1/courses/{courseId}/topics
返回请求者被允许查看的主题列表。
patch PATCH /v1/courses/{courseId}/topics/{id}
更新主题的一个或多个字段。

REST 资源:v1.invitations

方法
accept POST /v1/invitations/{id}:accept
接受邀请、移除邀请,并将受邀用户添加为指定课程的教师或学生(视情况而定)。
create POST /v1/invitations
创建邀请。
delete DELETE /v1/invitations/{id}
删除邀请。
get GET /v1/invitations/{id}
Returns an invitation.
list GET /v1/invitations
Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request.

REST 资源:v1.registrations

方法
create POST /v1/registrations
创建 Registration,导致 Google 课堂开始从所提供的 feedcloudPubSubTopic 中提供的目标发送通知。
delete DELETE /v1/registrations/{registrationId}
删除 Registration,导致 Google 课堂停止发送有关该 Registration 的通知。

REST 资源:v1.userProfiles

方法
checkUserCapability GET /v1/userProfiles/{userId}:checkUserCapability
返回用户是否可以使用指定的 Google 课堂功能。
get GET /v1/userProfiles/{userId}
返回用户个人资料。

REST 资源:v1.userProfiles.guardianInvitations

方法
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
创建监护人邀请,并向监护人发送电子邮件,要求他们确认自己是学生的监护人。
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
返回特定的监护人邀请。
list GET /v1/userProfiles/{studentId}/guardianInvitations
返回请求用户有权查看的监护人邀请列表,并按所提供的参数进行过滤。
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
修改监护人邀请。

REST 资源:v1.userProfiles.guardians

方法
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
删除监护人。
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
Returns a specific guardian.
list GET /v1/userProfiles/{studentId}/guardians
返回请求用户可以查看的监护人列表,仅限与请求匹配的监护人。