Method: courses.posts.addOnAttachments.patch

更新插件附件。

该插件必须是附件的原创建者。

此方法会返回以下错误代码：

  • PERMISSION_DENIED：访问错误。
  • 如果请求格式有误，则返回 INVALID_ARGUMENT。
  • 如果其中一个已标识的资源不存在，则为 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。
postId

string

必需。附件所附帖子的标识符。
attachmentId

string

必需。连接的标识符。

查询参数

参数
itemId

string

附件所附帖子的标识符。
updateMask

string (FieldMask format)

必需。用于标识要更新的附件上的哪些字段的掩码。如果指定了无效字段，更新将失败。如果某个字段支持空值，则可以通过在更新掩码（而不是在 AddOnAttachment 对象）中指定该字段来清除该字段。如果更新掩码中包含不支持空值的字段，且 AddOnAttachment 对象中未设置该字段，系统会返回 INVALID_ARGUMENT 错误。

教师可以指定以下字段：

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅授权指南。