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 到 1,000 个字符之间。
teacherViewUri

object (EmbedUri)

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

object (EmbedUri)

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

object (EmbedUri)

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

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

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

EmbedUri

填充查询参数后要用 iframe 嵌入的 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

 更新插件附件。