管理 Google 课堂中的课程、学生名单和邀请。
- REST 资源:v1.courses
- REST 资源:v1.courses.aliases
- REST 资源:v1.courses.announcements
- REST 资源:v1.courses.announcements.addOnAttachments
- REST 资源:v1.courses.courseWork
- REST 资源:v1.courses.courseWork.addOnAttachments
- REST 资源:v1.courses.courseWork.addOnAttachments.studentSubmissions
- REST 资源:v1.courses.courseWork.rubrics
- REST 资源:v1.courses.courseWork.studentSubmissions
- REST 资源:v1.courses.courseWorkMaterials
- REST 资源:v1.courses.courseWorkMaterials.addOnAttachments
- REST 资源:v1.courses.posts
- REST 资源:v1.courses.posts.addOnAttachments
- REST 资源:v1.courses.posts.addOnAttachments.studentSubmissions
- REST 资源:v1.courses.students
- REST 资源:v1.courses.teachers
- REST 资源:v1.courses.topics
- REST 资源:v1.invitations
- REST 资源:v1.registrations
- REST 资源:v1.userProfiles
- REST 资源:v1.userProfiles.guardianInvitations
- REST 资源:v1.userProfiles.guardians
服务:classroom.googleapis.com
如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。
发现文档
发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:
服务端点
服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:
https://classroom.googleapis.com
REST 资源:v1.courses
方法 | |
---|---|
checkAddOnCreationEligibility |
GET /v1/courses/{courseId}:checkAddOnCreationEligibility 返回用户是否有资格在指定课程中创建插件附件。 |
checkGradingPeriodsSetupEligibility |
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} 返回插件附件。 |
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} 返回课程作业。 |
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} 返回插件附件。 |
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 课堂开始从所提供的 feed 向 cloudPubSubTopic 中提供的目标发送通知。 |
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 返回发出请求的用户可以查看的监护人的列表(仅限与请求相匹配的监护人)。 |