REST Resource: courses.courseWorkMaterials.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

不可变。附件附加到的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。每个课程都是唯一的。

id

string

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

title

string

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

teacherViewUri

object (EmbedUri)

必需。用于显示教师视图附件的 URI。该 URI 将在 iframe 中打开,并设置 courseIditemIditemTypeattachmentId 查询参数。

studentViewUri

object (EmbedUri)

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

studentWorkReviewUri

object (EmbedUri)

供教师查看学生作业的 URI(如果适用)。系统会在 iframe 中打开该 URI,并设置 courseIditemIditemTypeattachmentIdsubmissionId 查询参数。这与学生查看附件时在 AddOnContext.studentContext 字段中返回的 submissionId 相同。如果省略或移除 URI,maxPoints 也会被舍弃。

dueDate

object (Date)

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

dueTime

object (TimeOfDay)

此附件截止时间(以世界协调时间 [UTC] 为单位)。如果指定了 dueDate,则必须指定此字段。

maxPoints

number

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

copyHistory[]

object (CopyHistory)

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

如果该附件之前因其父级帖子被复制而被复制,则此字段会按复制时间的升序顺序枚举之前的附件副本的标识符。

方法

create

在帖子下创建插件附件。

delete

删除插件附件。

get

返回插件附件。

list

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

patch

更新插件附件。