REST Resource: courses.posts.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 将在 iframe 中打开,并且设置了 courseIdpostIdattachmentId 查询参数。

studentViewUri

object (EmbedUri)

必需。用于显示学生查看附件的 URI。URI 将在 iframe 中打开,并且设置了 courseIdpostIdattachmentId 查询参数。

studentWorkReviewUri

object (EmbedUri)

供教师查看学生作业的 URI(如果适用)。URI 将在 iframe 中打开,并且设置了 courseIdpostIdattachmentIdsubmissionId 查询参数。这与学生查看附件时 [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] 返回的 submissionId 相同。如果省略或移除 URI,maxPoints 也会被舍弃。

dueDate

object (Date)

处理此附件的截止日期(采用世界协调时间 [UTC])。如果指定了 dueTime,则必须指定此字段。

dueTime

object (TimeOfDay)

处理此附件的时间(采用世界协调时间)是截止期限。如果指定了 dueDate,则必须指定此字段。

maxPoints

number

此附件的最高成绩。只有在已设置 studentWorkReviewUri 的情况下才能设置。设置为非零值以指示附件支持成绩回传。如果设置此字段,此值必须是非负整数值。如果将值设为 0,附件将不支持成绩回传。

copyHistory[]

object (CopyHistory)

仅限输出。作为此附件先前副本的附件的标识符。

如果附件之前是通过复制其父帖子而复制的,则此字段会按复制时间的升序列出作为其先前副本的附件的标识符。

方法

create

在帖子下创建插件附件。

delete

删除插件附件。

get

返回插件附件。

list

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

patch

更新插件附件。