Method: courses.posts.addOnAttachments.studentSubmissions.patch

アドオンの添付ファイルの送信に関連付けられたデータを更新します。

アドオンが添付ファイルの元の作成者であり、添付ファイルに正の maxPoints 値が設定されている必要があります。

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

  • PERMISSION_DENIED: アクセスエラー。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • NOT_FOUND: 識別されたリソースのいずれかが存在しない場合。

HTTP リクエスト

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

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

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。
postId
(deprecated)

string

省略可。非推奨。代わりに itemId を使用してください。
attachmentId

string

必須。アタッチメントの ID。
submissionId

string

必須。生徒の提出物の ID。

クエリ パラメータ

パラメータ
itemId

string

アタッチメントが接続されている Announcement、CourseWork、または CourseWorkMaterial の識別子。このフィールドは必須ですが、postId からの移行中はそのようにマークされません。
updateMask

string (FieldMask format)

必須。更新する添付ファイルのフィールドを識別するマスク。無効なフィールドを指定すると、更新は失敗します。フィールドが空の値をサポートしている場合、AddOnAttachmentStudentSubmission オブジェクトではなく更新マスクで指定することでクリアできます。

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

  • pointsEarned

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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