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

必需。课程的标识符。
itemId

string

附件附加到的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。此字段是必填字段，但在从 postId 迁移期间未被标记为必填字段。
attachmentId

string

必需。附件的标识符。
submissionId

string

必需。学生提交内容的标识符。

查询参数

参数
postId
(deprecated)

string

可选。已弃用，请改用 itemId。
updateMask

string (FieldMask format)

必需。用于标识要更新的附件字段的掩码。如果指定无效字段，更新将失败。如果某个字段支持空值，则可以在更新掩码中（而非 AddOnAttachmentStudentSubmission 对象中）指定该字段，以清除该字段。

教师可以指定以下字段：

  • pointsEarned

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。

请求正文

请求正文包含一个 AddOnAttachmentStudentSubmission 实例。

响应正文

如果成功，则响应正文包含一个 AddOnAttachmentStudentSubmission 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅授权指南。