所有している生徒に代わって生徒の提出物を取り戻します。
生徒の提出物を取り戻すと、添付されているドライブ ファイルのオーナー権限が生徒に移り、提出物のステータスが更新されます。
このメソッドを呼び出すことができるのは、リクエストされた生徒の提出物を所有している生徒のみで、提出済みの生徒の提出物に対してのみ呼び出すことができます。
このリクエストは、対応するコースワーク アイテムまたは対応するコースワーク アイテムのアドオンの添付ファイルの作成に使用された OAuth クライアント ID のデベロッパー コンソール プロジェクトから行う必要があります。
このメソッドは、次のエラーコードを返します。
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 |
生徒の提出物の識別子。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文は空の JSON オブジェクトになります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/classroom.coursework.me
詳細については、認可ガイドをご覧ください。