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

不可變動。課程的 ID。
postId
(deprecated)

string

不可變動。已淘汰，請改用 itemId。
itemId

string

不可變動。附件所屬的 Announcement、CourseWork 或 CourseWorkMaterial 的 ID。每門課程皆有專屬 ID。
id

string

不可變動。這個附件的 Classroom 指派 ID，每則貼文皆不相同。
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)

這個附件的工作期限 (以世界標準時間為準)。如果指定 dueTime，則必須指定此值。
dueTime

object (TimeOfDay)

這個附件的工作期限，以世界標準時間為準。如果指定 dueDate，則必須指定此值。
maxPoints

number

此附件的最高成績。只有在設定 studentWorkReviewUri 時才可設定。將其設為非零值，表示附件支援成績回傳功能。如果已設定，則此值必須為非負整數。設為零時，附件將不支援成績回傳。
copyHistory[]

object (CopyHistory)

僅供輸出。這個附件先前副本的 ID。

如果附件是因為父項貼文而先前複製，則會以遞增的時間順序列舉先前複製的附件 ID。

EmbedUri

填入查詢參數後，要以 iframe 顯示的 URI。

JSON 表示法 
{
  "uri": string
}
欄位
uri

string

必要欄位。在填入查詢參數後，要以 iframe 顯示的 URI。這必須是有效的 UTF-8 字串，長度介於 1 到 1800 個半形字元之間。

CopyHistory

指定附件先前副本的 ID。

JSON 表示法 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
欄位
courseId

string

不可變動。課程的 ID。
postId
(deprecated)

string

不可變動。已淘汰，請改用 itemId。
itemId

string

不可變動。附件所屬的 Announcement、CourseWork 或 CourseWorkMaterial 的 ID。
attachmentId

string

不可變動。附件的 ID。

方法

create

 在貼文下方建立外掛程式附件。

delete

 刪除外掛程式附件。

get

 傳回外掛程式附件。

list

 傳回貼文下方由外掛程式建立的所有附件。

patch

 更新外掛程式附件。