Method: courses.courseWork.studentSubmissions.return

生徒の提出物を返します。

生徒が提出物を返却すると、添付ファイルのオーナー権限が生徒に移ります。また、提出物のステータスが更新されることもあります。Classroom アプリケーションとは異なり、生徒の提出物を返却しても、AssignedGrade が draftGrade の値に設定されることはありません。

このメソッドを呼び出すことができるのは、リクエストした生徒の提出物が含まれているコースの教師のみです。

このリクエストは、対応するコース作業アイテムの作成に使用される OAuth クライアント ID の Developer Console プロジェクトから行う必要があります。

このメソッドは、次のエラーコードを返します。

  • PERMISSION_DENIED: リクエスト元のユーザーがリクエストされたコースまたはコースの課題へのアクセスを許可されていない場合は、リクエストされた生徒の提出物を返却するか、アクセスエラーを指定します。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • リクエストされたコース、コースの課題、生徒の提出物が存在しない場合は NOT_FOUND。

HTTP リクエスト

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

コースの識別子。この識別子は、Classroom で割り当てられた識別子または alias です。
courseWorkId

string

コースの課題の識別子。
id

string

生徒の提出物の ID。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/classroom.coursework.students

詳細については、承認ガイドをご覧ください。