それを所有する生徒に代わって、生徒の提出物を再利用します。
生徒が提出物を再利用すると、添付ファイルのオーナー権限が生徒に移り、提出物の状態が更新されます。
このメソッドを呼び出すことができるのは、リクエストされた生徒の提出物を所有している生徒のみです。また、提出済みの生徒の提出物に対してのみ、このメソッドを呼び出すことができます。
このリクエストは、対応するコース作業アイテムの作成に使用される OAuth クライアント ID の Developer Console プロジェクトから行う必要があります。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
(リクエスト元のユーザーがリクエストされたコースまたはコースの課題へのアクセスを許可されていない場合は、リクエストされた生徒の提出物の提出を取り消します。または、アクセスエラーのため)。FAILED_PRECONDITION
(生徒からの提出が未提出の場合)。INVALID_ARGUMENT
: リクエストの形式が正しくない場合。- リクエストされたコース、コースの課題、生徒の提出物が存在しない場合は
NOT_FOUND
。
HTTP リクエスト
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
courseId |
コースの識別子。この識別子は、Classroom で割り当てられた識別子または |
courseWorkId |
コースの課題の識別子。 |
id |
生徒の提出物の ID。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文は空になります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/classroom.coursework.me
詳細については、承認ガイドをご覧ください。