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

不可变。附件附加到的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。每个课程的 ID 都不相同。

id

string

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

title

string

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

teacherViewUri

object (EmbedUri)

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

studentViewUri

object (EmbedUri)

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

studentWorkReviewUri

object (EmbedUri)

教师用于查看附件中学生作业的 URI(如果适用)。该 URI 将在 iframe 中打开,并设置 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

更新插件附件。