REST Resource: courses.announcements.addOnAttachments

资源：AddOnAttachment <ph type="x-smartling-placeholder">
- JSON 表示法
- EmbedUri <ph type="x-smartling-placeholder">
  - JSON 表示法
- CopyHistory <ph type="x-smartling-placeholder">
  - JSON 表示法
方法

资源：AddOnAttachment

帖子中的插件附件。

JSON 表示法

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": 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` 不可变。附件所在的通知、courseWork 或 courseWorkMaterial 的标识符。每个课程都是唯一的。
`id`	`string` 不可变。课堂为此附件分配的标识符，每个帖子都是唯一的。
`title`	`string` 必需。此附件的标题。标题长度必须介于 1 到 1000 个字符之间。
`teacherViewUri`	`object (EmbedUri)` 必需。用于显示教师视图附件的 URI。URI 将在 iframe 中打开，并且设置了 `courseId`、`postId` 和 `attachmentId` 查询参数。
`studentViewUri`	`object (EmbedUri)` 必需。用于显示学生查看附件的 URI。URI 将在 iframe 中打开，并且设置了 `courseId`、`postId` 和 `attachmentId` 查询参数。
`studentWorkReviewUri`	`object (EmbedUri)` 供教师查看学生作业的 URI（如果适用）。URI 将在 iframe 中打开，并且设置了 `courseId`、`postId`、`attachmentId` 和 `submissionId` 查询参数。这与学生查看附件时 [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] 返回的 `submissionId` 相同。如果省略或移除 URI，`maxPoints` 也会被舍弃。
`dueDate`	`object (Date)` 处理此附件的截止日期（采用世界协调时间 [UTC]）。如果指定了 `dueTime`，则必须指定此字段。
`dueTime`	`object (TimeOfDay)` 处理此附件的时间（采用世界协调时间）是截止期限。如果指定了 `dueDate`，则必须指定此字段。
`maxPoints`	`number` 此附件的最高成绩。只有在已设置 `studentWorkReviewUri` 的情况下才能设置。设置为非零值以指示附件支持成绩回传。如果设置此字段，此值必须是非负整数值。如果将值设为 0，附件将不支持成绩回传。
`copyHistory[]`	`object (CopyHistory)` 仅限输出。作为此附件先前副本的附件的标识符。如果附件之前是通过复制其父帖子而复制的，则此字段会按复制时间的升序列出作为其先前副本的附件的标识符。

EmbedUri

在填充查询参数后要成为 iframe 的 URI。

JSON 表示法
{ "uri": string }

字段

字段
`uri`	`string` 必需。在填充查询参数后要成为 iframe 的 URI。此值必须是一个有效的 UTF-8 字符串，长度介于 1 到 1800 个字符之间。

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` 不可变。附件所在的通知、courseWork 或 courseWorkMaterial 的标识符。
`attachmentId`	`string` 不可变。附件的标识符。

方法
`create`	在帖子下创建插件附件。
`delete`	删除插件附件。
`get`	返回插件附件。
`list`	返回相应帖子下的插件创建的所有附件。
`patch`	更新插件附件。

REST Resource: courses.announcements.addOnAttachments

资源：AddOnAttachment

EmbedUri

CopyHistory

方法

`create`

`delete`

`get`

`list`

`patch`