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

string

不可變動。Classroom 為這個附件指派的 ID，每則訊息的專屬 ID。
title

string

必要欄位。這個附件的標題。標題長度必須介於 1 至 1000 個半形字元之間。
teacherViewUri

object (EmbedUri)

必要欄位。用來顯示老師檢視附件的 URI。URI 會在 iframe 中開啟，並設定 courseId、itemId、itemType 和 attachmentId 查詢參數。
studentViewUri

object (EmbedUri)

必要欄位。用來顯示學生檢視附件的 URI。URI 會在已設定 courseId、itemId、itemType 和 attachmentId 查詢參數的 iframe 中開啟。
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 時才能設定。將其設為非零值，表示附件支援成績回傳功能。如要設定，則此值必須為非負整數。如果設為 0，附件將不支援回傳成績。
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

 更新外掛程式附件。