Google Classroom アドオンの一般提供が開始されました。詳しくは、
アドオンのドキュメントをご覧ください。
Method: courses.courseWork.studentSubmissions.turnIn
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
生徒が提出物を提出します。
生徒の提出物を提出すると、添付されたドライブ ファイルのオーナー権限が教師に移行され、提出物のステータスが更新されることもあります。
この関数は、指定された生徒の提出物を所有する生徒のみが呼び出すことができます。
このリクエストは、対応する課題アイテムの作成に使用された OAuth クライアント ID の Developer Console プロジェクトから行う必要があります。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
: リクエストしたユーザーが、リクエストされたコースまたはコースワークにアクセスする権限がない場合、リクエストされた生徒の提出物を提出できない場合、またはアクセス エラーの場合。
INVALID_ARGUMENT
: リクエストの形式が正しくない場合。
NOT_FOUND
: リクエストされたコース、コースの課題、生徒の提出物が存在しない場合。
HTTP リクエスト
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
courseId |
string
コースの識別子。この識別子は、Classroom に割り当てられた識別子または alias のいずれかです。
|
courseWorkId |
string
コースの課題の識別子。
|
id |
string
生徒の提出物の識別子。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文は空の JSON オブジェクトになります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/classroom.coursework.me
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],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)."]]