Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

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

アタッチメントの元の作成者がアドオンであり、アタッチメントに正の maxPoints 値が設定されている必要があります。

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。
itemId

string

添付ファイルが接続されている Announcement、CourseWork、CourseWorkMaterial の ID。このフィールドは必須ですが、postId から移行中は必須としてマークされません。
attachmentId

string

必須。添付ファイルの識別子。
submissionId

string

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

クエリ パラメータ

パラメータ
postId
(deprecated)

string

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

string (FieldMask format)

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

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

  • pointsEarned

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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