Google Classroom アドオンの一般提供が開始されました。詳しくは、
アドオンのドキュメントをご覧ください。
Method: courses.courseWork.studentSubmissions.modifyAttachments
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
生徒の提出物の添付ファイルを変更します。
添付ファイルを追加できるのは、workType
が ASSIGNMENT
のコースワーク オブジェクトに属する生徒の提出物に限られます。
このリクエストは、対応する課題アイテムの作成に使用された OAuth クライアント ID の Developer Console プロジェクトから行う必要があります。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
: リクエストしたユーザーがリクエストしたコースまたはコースワークにアクセスできない場合、リクエストした生徒の提出物の添付ファイルを変更できない場合、アクセス エラーの場合。
INVALID_ARGUMENT
: リクエストの形式が正しくない場合。
NOT_FOUND
: リクエストされたコース、コースの課題、生徒の提出物が存在しない場合。
HTTP リクエスト
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
courseId |
string
コースの識別子。この識別子は、Classroom に割り当てられた識別子または 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 Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],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)."]]