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

有关详情,请参阅授权指南