Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
Method: courses.courseWork.studentSubmissions.turnIn
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
繳交學生作業。
學生提交內容時,系統會將附加的 Google 雲端硬碟檔案擁有權轉移給老師,並可能更新提交狀態。
只有擁有指定學生提交內容的學生才能呼叫這個方法。
這項要求必須由開發人員控制台專案提出,該專案的 OAuth 用戶端 ID 用於建立對應的課程作業項目。
這個方法會傳回下列錯誤代碼:
PERMISSION_DENIED
如果要求使用者未獲准存取要求的課程或課程作業,請繳交要求的學生提交內容,或發生存取錯誤。
INVALID_ARGUMENT
:如果要求格式錯誤。
NOT_FOUND
如果要求的課程、課程作業或學生提交內容不存在。
HTTP 要求
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
courseId |
string
課程的 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias 。
|
courseWorkId |
string
課程作業的 ID。
|
id |
string
學生提交作業的 ID。
|
回應主體
如果成功,回應主體會是空的 JSON 物件。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/classroom.coursework.me
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間: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)."]]