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}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
courseId

string

必要欄位。課程的 ID。

itemId

string

附加附件的 AnnouncementCourseWorkCourseWorkMaterial ID。這是必要欄位,不過在從 postId 進行遷移時,系統不會標示此欄位。

attachmentId

string

必要欄位。附件的 ID。

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

詳情請參閱授權指南