Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Method: courses.courseWork.studentSubmissions.turnIn
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
提交学生提交的内容。
上交学生提交的作业后,系统会将所附云端硬盘文件的所有权转移给教师,并且可能会更新提交状态。
只有拥有指定学生提交内容的学生才能调用此方法。
此请求必须由用于创建相应课业内容项的 OAuth 客户端 ID 的 Play 管理中心项目发出。
此方法会返回以下错误代码:
- 如果请求访问的用户无权访问请求的课程或课业、上交请求的学生提交内容,或者出现访问错误,则返回
PERMISSION_DENIED
。
- 如果请求格式不正确,则返回
INVALID_ARGUMENT
。
- 如果请求的课程、课业或学生提交内容不存在,则为
NOT_FOUND
。
HTTP 请求
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
网址采用 gRPC 转码语法。
路径参数
参数 |
courseId |
string
课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias 。
|
courseWorkId |
string
课程作业的标识符。
|
id |
string
学生提交内容的标识符。
|
响应正文
如果成功,则响应正文为空的 JSON 对象。
授权范围
需要以下 OAuth 范围:
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.turnIn\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nTurns in a student submission.\n\nTurning in a student submission transfers ownership of attached Drive files to the teacher and may also update the submission state.\n\nThis may only be called by the student that owns the specified student submission.\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, turn in 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}:turnIn`\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 must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]