REST Resource: courses.announcements.addOnAttachments

资源：AddOnAttachment

帖子中的插件附件。

JSON 表示法 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "id": string,
  "title": string,
  "teacherViewUri": {
    object (EmbedUri)
  },
  "studentViewUri": {
    object (EmbedUri)
  },
  "studentWorkReviewUri": {
    object (EmbedUri)
  },
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "maxPoints": number,
  "copyHistory": [
    {
      object (CopyHistory)
    }
  ]
}
字段
courseId

string

不可变。课程的标识符。
postId
(deprecated)

string

不可变。已弃用，请改用 itemId。
itemId

string

不可变。附件所属的通知、courseWork 或 courseWorkMaterial 的标识符。每门课程都是唯一的。
id

string

不可变。课堂为此附件分配的标识符，每个帖子都是唯一的。
title

string

必需。此附件的标题。标题长度必须介于 1 到 1000 个字符之间。
teacherViewUri

object (EmbedUri)

必需。用于显示附件的教师视图的 URI。URI 将在设置了 courseId、postId 和 attachmentId 查询参数的 iframe 中打开。
studentViewUri

object (EmbedUri)

必需。用于显示附件的学生视图的 URI。URI 将在设置了 courseId、postId 和 attachmentId 查询参数的 iframe 中打开。
studentWorkReviewUri

object (EmbedUri)

供教师查看学生作业的 URI（如果适用）。URI 将在设置了 courseId、postId、attachmentId 和 submissionId 查询参数的 iframe 中打开。这与学生查看附件时 [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] 返回的 submissionId 相同。如果省略或移除 URI，maxPoints 也会被舍弃。
dueDate

object (Date)

此附件的工作截止日期（采用世界协调时间）。如果指定了 dueTime，则必须指定此字段。
dueTime

object (TimeOfDay)

此附件的工作截止日期（采用世界协调时间）。如果指定了 dueDate，则必须指定此字段。
maxPoints

number

此附件的最高成绩。只有在已设置 studentWorkReviewUri 时才能设置。将值设为非零值，以表明附件支持成绩回传。如果设置，则此值必须是非负整数值。如果将值设为 0，附件将不支持成绩回传。
copyHistory[]

object (CopyHistory)

仅供输出。附件是此附件以前的副本的标识符。

如果附件之前是通过复制的父级帖子而复制的，则枚举以前副本的附件标识符（按复制时间的升序排列）。

EmbedUri

使用查询参数填充后要进行 iframe 嵌入的 URI。

JSON 表示法 
{
  "uri": string
}
字段
uri

string

必需。使用查询参数填充后要进行 iframe 嵌入的 URI。此值必须是包含 1 到 1800 个字符的有效 UTF-8 字符串。

CopyHistory

给定附件的旧副本的标识符。

JSON 表示法 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
字段
courseId

string

不可变。课程的标识符。
postId
(deprecated)

string

不可变。已弃用，请改用 itemId。
itemId

string

不可变。附件所属的通知、courseWork 或 courseWorkMaterial 的标识符。
attachmentId

string

不可变。连接的标识符。

方法

create

 在帖子下创建插件附件。

delete

 删除插件附件。

get

 返回插件附件。

list

 返回帖子下由插件创建的所有附件。

patch

 更新插件附件。