Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Method: courses.courseWork.studentSubmissions.modifyAttachments
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
修改学生提交内容的附件。
只能向 workType
为 ASSIGNMENT
的课业对象所属的学生提交内容添加附件。
此请求必须由用于创建相应课业内容项的 OAuth 客户端 ID 的 Play 管理中心项目发出。
此方法会返回以下错误代码:
PERMISSION_DENIED
:如果系统不允许请求访问的用户访问所请求的课程或课业,如果系统不允许该用户修改所请求的学生提交内容中的附件,或者如果出现访问错误。
- 如果请求格式不正确,则返回
INVALID_ARGUMENT
。
- 如果请求的课程、课业或学生提交内容不存在,则为
NOT_FOUND
。
HTTP 请求
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
网址采用 gRPC 转码语法。
路径参数
参数 |
courseId |
string
课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias 。
|
courseWorkId |
string
课程作业的标识符。
|
id |
string
学生提交内容的标识符。
|
请求正文
请求正文中包含结构如下的数据:
字段 |
addAttachments[] |
object (Attachment )
要添加的附件。学生提交的内容不得超过 20 个附件。 不支持 Form 附件。
|
previewVersion |
enum (PreviewVersion )
可选。API 的预览版。必须设置此值,才能使用预览版计划中向开发者提供的新 API 功能。
|
响应正文
如果成功,则响应正文包含一个 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.modifyAttachments\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nModifies attachments of student submission.\n\nAttachments may only be added to student submissions belonging to course work objects with a `workType` of `ASSIGNMENT`.\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 user is not permitted to access the requested course or course work, if the user is not permitted to modify attachments on the requested 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`POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments`\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### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"addAttachments\": [ { object (/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#Attachment) } ], \"previewVersion\": enum (/workspace/classroom/reference/rest/v1/PreviewVersion) } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `addAttachments[]` | `object (`[Attachment](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#Attachment)`)` Attachments to add. A student submission may not have more than 20 attachments. [Form](/workspace/classroom/reference/rest/v1/Form) attachments are not supported. |\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### 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)."]]