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