REST Resource: courses.courseWork.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 都不相同。

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)

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

maxPoints

number

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

copyHistory[]

object (CopyHistory)

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

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

方法

create

在帖子下创建插件附件。

delete

删除插件附件。

get

返回插件附件。

list

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

patch

更新插件附件。