Method: courses.courseWork.studentSubmissions.patch

生徒の提出物の 1 つ以上のフィールドを更新します。

更新できるフィールドと、それらを変更できるユーザーの詳細については、google.classroom.v1.StudentSubmission をご覧ください。

このリクエストは、対応する課題アイテムの作成に使用された OAuth クライアント ID のデベロッパー コンソール プロジェクト、または対応する課題アイテムで成績同期が有効になっているアドオン添付ファイルによって行う必要があります。

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

  • リクエスト元のデベロッパー プロジェクトが、対応するコースワークまたは対応するコースワークのアドオン添付ファイル（成績同期が有効）を作成していない場合、ユーザーがリクエストされた生徒の提出物に対する変更を許可されていない場合、またはアクセス エラーの場合、PERMISSION_DENIED。
  • リクエストの形式が正しくない場合は INVALID_ARGUMENT。
  • リクエストされたコース、コースの課題、生徒の提出物が存在しない場合は NOT_FOUND。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

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

string

コース課題の識別子。
id

string

生徒の提出物の識別子。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

生徒の提出物で更新するフィールドを特定するマスク。このフィールドは更新を行うために必須です。無効なフィールドが指定されている場合、更新は失敗します。

教師は次のフィールドを指定できます。

  • draftGrade
  • assignedGrade

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
previewVersion

enum (PreviewVersion)

省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、この設定を行う必要があります。

リクエストの本文

リクエストの本文には StudentSubmission のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には StudentSubmission のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

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