生徒の提出物の添付ファイルを変更します。
添付ファイルを追加できるのは、workType が ASSIGNMENT のコースワーク オブジェクトに属する生徒の提出物のみです。
このリクエストは、対応するコースワーク アイテムを作成するために使用される OAuth クライアント ID のデベロッパー コンソール プロジェクト、または対応するコースワーク アイテムのアドオン添付ファイルによって行う必要があります。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIEDリクエスト元のユーザーがリクエストされたコースまたはコースワークにアクセスできない場合、リクエストされた生徒の提出物の添付ファイルを変更できない場合、または アクセス エラーが発生した場合。- リクエストの形式が正しくない場合は、
INVALID_ARGUMENT。 - リクエストされたコース、コースワーク、生徒の提出物が存在しない場合は、
NOT_FOUND。
HTTP リクエスト
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
courseId |
コースの識別子。この識別子は、Classroom によって割り当てられた識別子または |
courseWorkId |
コースワークの識別子。 |
id |
生徒の提出物の識別子。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "addAttachments": [ { object ( |
| フィールド | |
|---|---|
addAttachments[] |
追加する添付ファイル。生徒の提出物の添付ファイルは 20 個までです。
|
previewVersion |
省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、これを設定する必要があります。 |
レスポンスの本文
成功した場合、レスポンスの本文には StudentSubmission のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/classroom.coursework.studentshttps://www.googleapis.com/auth/classroom.coursework.me
詳細については、認可ガイドをご覧ください。