REST Resource: courses.posts.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)
    }
  ],
  "gradeSyncEnabled": boolean
}
欄位
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 會在 iframe 中開啟，並設定 courseId、itemId、itemType 和 attachmentId 查詢參數。
studentWorkReviewUri

object (EmbedUri)

老師查看學生作業附件的 URI (如適用)。系統會在 iframe 中開啟 URI，並設定 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。
gradeSyncEnabled

boolean

僅供輸出。是否要將這個附件 student submissions 的 pointsEarned 值變更，複製到學生 CourseWork submissions 的 pointsEarned 欄位。每個訊息串項目最多只能有一個外掛程式附件，其欄位可設為 true。

方法

create

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

delete

 刪除外掛程式附件。

get

 傳回外掛程式附件。

list

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

patch

 更新外掛程式附件。