Method: courses.courseWork.studentSubmissions.return

返回学生提交的作业。

学生发回作业后，系统会将附加的云端硬盘文件的所有权转移给学生，并且学生还可以更新提交状态。与 Google 课堂应用不同，发回学生提交的作业时，不将 AssignedGrade 的值设为 draftGrade。

只有包含所请求学生提交的作业的课程的教师才能调用此方法。

此请求必须由用于创建相应课程作业项的 OAuth 客户端 ID 的 Developer Console 项目提出。

此方法会返回以下错误代码：

  • PERMISSION_DENIED如果发出请求的用户无权访问所请求的课程或课程作业，请发回所要求的学生提交内容，或因访问错误导致访问错误。
  • 如果请求格式有误，则返回 INVALID_ARGUMENT。
  • 如果请求的课程、课程作业或学生提交的内容不存在，则为 NOT_FOUND。

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

课程的标识符。此标识符可以是 Google 课堂分配的标识符，也可以是 alias。
courseWorkId

string

课程作业的标识符。
id

string

学生提交的作业的标识符。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/classroom.coursework.students

有关详情，请参阅授权指南。