生徒の提出物の添付ファイルを変更します。
添付ファイルを追加できるのは、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 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
course |
コースの識別子。この識別子は、Classroom で割り当てられた識別子または |
course |
コースの課題の識別子。 |
id |
生徒の提出物の識別子。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "addAttachments": [ { object ( |
フィールド | |
---|---|
add |
追加する添付ファイル。生徒が提出する課題に添付できるファイルは 20 個までです。
|
preview |
省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、このフラグを設定する必要があります。 |
レスポンスの本文
成功した場合、レスポンスの本文には StudentSubmission
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
詳しくは、認可ガイドをご覧ください。