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

生徒の提出物の識別子。

リクエストの本文

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

レスポンスの本文

成功した場合、レスポンスの本文は空の JSON オブジェクトになります。

認可スコープ

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

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

詳しくは、認可ガイドをご覧ください。