REST Resource: courses.courseWork.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 會在已設定 courseId、itemId、itemType 和 attachmentId 查詢參數的 iframe 中開啟。
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。

方法

create

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

delete

 刪除外掛程式附件。

get

 傳回外掛程式附件。

list

 傳回在文章底下由外掛程式建立的所有附件。

patch

 更新外掛程式附件。