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)
    }
  ],
  "gradeSyncEnabled": boolean
}
字段
courseId

string

不可变。课程的标识符。

postId
(deprecated)

string

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

itemId

string

不可变。附件所附加到的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。每个课程的唯一标识符。

id

string

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

title

string

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

teacherViewUri

object (EmbedUri)

必需。用于显示附件教师视图的 URI。系统将在 iframe 中打开该 URI,并设置 courseId、itemId、itemType 和 attachmentId 查询参数。

studentViewUri

object (EmbedUri)

必需。用于显示附件的学生视图的 URI。系统将在 iframe 中打开该 URI,并设置 courseId、itemId、itemType 和 attachmentId 查询参数。

studentWorkReviewUri

object (EmbedUri)

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

dueDate

object (Date)

此附件的作业截止日期(世界协调时间 [UTC])。如果指定了 dueTime,则必须指定此参数。

dueTime

object (TimeOfDay)

此附件的作业截止时间(世界协调时间 [UTC])。如果指定了 dueDate,则必须指定此参数。

maxPoints

number

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

copyHistory[]

object (CopyHistory)

仅限输出。此附件之前副本的附件标识符。

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

gradeSyncEnabled

boolean

仅限输出。是否将此附件的学生提交内容中 pointsEarned 值的更改复制到学生课程作业提交内容中的 pointsEarned 字段。对于每个信息流内容,最多只能有一个插件附件的此字段为 true。

方法

create

在帖子下创建插件附件。

delete

删除插件附件。

get

返回插件附件。

list

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

patch

更新插件附件。