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

不可變動。附加附件中的公告、CourseWork 或 courseWorkMaterial ID。每門課程皆不得重複。

id

string

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

title

string

必要欄位。這個附件的標題。標題的長度必須介於 1 至 1,000 個字元之間。

teacherViewUri

object (EmbedUri)

必要欄位。顯示附件為老師檢視畫面的 URI。URI 會在已設定 courseIdpostIdattachmentId 查詢參數的 iframe 中開啟。

studentViewUri

object (EmbedUri)

必要欄位。顯示學生對附件檢視畫面的 URI。URI 會在已設定 courseIdpostIdattachmentId 查詢參數的 iframe 中開啟。

studentWorkReviewUri

object (EmbedUri)

老師可在附件中查看學生作業的 URI (如適用)。URI 會在已設定 courseIdpostIdattachmentIdsubmissionId 查詢參數的 iframe 中開啟。這與學生查看附件時 [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] 傳回的 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。這必須是介於 1 至 1800 個字元的有效 UTF-8 字串。

CopyHistory

指定附件先前副本的 ID。

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

string

不可變動。課程的 ID。

postId
(deprecated)

string

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

itemId

string

不可變動。附加附件中的公告、CourseWork 或 courseWorkMaterial ID。

attachmentId

string

不可變動。附件的 ID。

方法

create

在訊息底下建立外掛程式附件。

delete

刪除外掛程式附件。

get

傳回外掛程式附件。

list

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

patch

更新外掛程式附件。