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

不可变。附件所附在的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。每个课程的 ID 都不相同。
id

string

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

string

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

object (EmbedUri)

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

object (EmbedUri)

必需。用于显示附件学生视图的 URI。URI 将在 iframe 中打开，并且设置了 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)

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

number

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

object (CopyHistory)

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

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

EmbedUri

填充查询参数后要嵌入的 URI。

JSON 表示法 
{
  "uri": string
}
字段
uri

string

必需。填充查询参数后要用 iframe 嵌入的 URI。此值必须是一个有效的 UTF-8 字符串，长度介于 1 到 1800 个字符之间。

CopyHistory

给定附件的先前副本的标识符。

JSON 表示法 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
字段
courseId

string

不可变。课程的标识符。
postId
(deprecated)

string

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

string

不可变。附件所附在的 Announcement、CourseWork 或 CourseWorkMaterial 的标识符。
attachmentId

string

不可变。附件的标识符。

方法

create

 在帖子下方创建插件附件。

delete

 删除插件附件。

get

 返回插件附件。

list

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

patch

 更新插件附件。