Method: courses.courseWork.studentSubmissions.patch

更新学生提交的一个或多个字段。

如需详细了解哪些字段可能会更新以及哪些人可以更改，请参阅google.classroom.v1.StudentSubmission。

该请求必须由用于创建相应课程作业项的 OAuth 客户端 ID 的开发者控制台项目发出。

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

  • PERMISSION_DENIED（如果发出请求的开发者项目未创建对应的课程作业）、用户无权对学生提交的作业进行所请求的修改，或者因为访问错误而未进行修改。
  • INVALID_ARGUMENT（如果请求格式不正确）。
  • 如果请求的课程、课程作业或学生提交的作业不存在，则为 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

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

string

课程作业的标识符。
id

string

学生提交的标识符。

查询参数

参数
updateMask

string (FieldMask format)

蒙版，用于标识学生提交内容中的哪些字段需要更新。必须填写此字段才能进行更新。如果指定了无效的字段，更新将会失败。

教师可以指定以下字段：

  • draftGrade
  • assignedGrade

这是完全限定字段名的逗号分隔列表。示例："user.displayName,photo"。

请求正文

请求正文包含一个 StudentSubmission 实例。

响应正文

如果成功，响应正文将包含一个 StudentSubmission 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅授权指南。