Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Method: courses.courseWork.studentSubmissions.patch
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新学生提交内容的一个或多个字段。
如需详细了解哪些字段可以更新以及哪些人可以更改这些字段,请参阅 google.classroom.v1.StudentSubmission
。
此请求必须由用于创建相应课业内容项的 OAuth 客户端 ID 的 Play 管理中心项目发出。
此方法会返回以下错误代码:
- 如果请求的开发者项目未创建相应的作业,如果用户未获准对学生提交的作业进行所请求的修改,或者出现访问错误,则返回
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)
用于标识要更新学生提交内容中的哪些字段的掩码。若要进行更新,必须填写此字段。如果指定无效字段,更新将失败。 教师可以指定以下字段:
这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo" 。
|
previewVersion |
enum (PreviewVersion )
可选。API 的预览版。必须设置此值,才能使用预览版计划中向开发者提供的新 API 功能。
|
请求正文
请求正文包含一个 StudentSubmission
实例。
响应正文
如果成功,则响应正文包含一个 StudentSubmission
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: courses.courseWork.studentSubmissions.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates one or more fields of a student submission.\n\nSee [google.classroom.v1.StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission) for details of which fields may be updated and who may change them.\n\nThis request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting developer project did not create the corresponding course work, if the user is not permitted to make the requested modification to the student submission, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course, course work, or student submission does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `courseWorkId` | `string` Identifier of the course work. |\n| `id` | `string` Identifier of the student submission. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Mask that identifies which fields on the student submission to update. This field is required to do an update. The update fails if invalid fields are specified. The following fields may be specified by teachers: - `draftGrade` - `assignedGrade` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission).\n\n### Response body\n\nIf successful, the response body contains an instance of [StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]