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

不可變動。附件所屬的 AnnouncementCourseWorkCourseWorkMaterial 的 ID。每門課程皆有專屬 ID。

id

string

不可變動。這個附件的 Classroom 指派 ID,每則貼文皆不相同。

title

string

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

teacherViewUri

object (EmbedUri)

必要欄位。用來顯示老師檢視附件的 URI。URI 會在 iframe 中開啟,並設定 courseIditemIditemTypeattachmentId 查詢參數。

studentViewUri

object (EmbedUri)

必要欄位。用於顯示學生檢視附件的 URI。URI 會在 iframe 中開啟,並設定 courseIditemIditemTypeattachmentId 查詢參數。

studentWorkReviewUri

object (EmbedUri)

URI,供老師查看學生在附件中提交的作業,如適用。URI 會在 iframe 中開啟,並設定 courseIditemIditemTypeattachmentIdsubmissionId 查詢參數。這與學生查看附件時,在 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

更新外掛程式附件。