REST Resource: courses.announcements.addOnAttachments

Tài nguyên: AddOnAttachment

Tệp đính kèm tiện ích bổ sung trên một bài đăng.

Biểu diễn dưới dạng 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)
    }
  ]
}
Trường
courseId

string

Không thể thay đổi. Giá trị nhận dạng của khoá học.

postId
(deprecated)

string

Không thể thay đổi. Không dùng nữa, hãy sử dụng itemId.

itemId

string

Không thể thay đổi. Giá trị nhận dạng của Announcement, CourseWork hoặc CourseWorkMaterial trong đó tệp đính kèm được đính kèm. Riêng biệt cho mỗi khoá học.

id

string

Không thể thay đổi. Giá trị nhận dạng do Lớp học chỉ định cho tệp đính kèm này, mỗi bài đăng có một giá trị nhận dạng riêng.

title

string

Bắt buộc. Tiêu đề của tệp đính kèm này. Tiêu đề phải có từ 1 đến 1.000 ký tự.

teacherViewUri

object (EmbedUri)

Bắt buộc. URI để hiển thị chế độ xem của giáo viên về tệp đính kèm. URI sẽ được mở trong một iframe với các tham số truy vấn courseId, itemId, itemTypeattachmentId được đặt.

studentViewUri

object (EmbedUri)

Bắt buộc. URI để hiển thị chế độ xem của học viên về tệp đính kèm. URI sẽ được mở trong một iframe với các tham số truy vấn courseId, itemId, itemTypeattachmentId được đặt.

studentWorkReviewUri

object (EmbedUri)

URI để giáo viên xem bài tập của học viên trên tệp đính kèm (nếu có). URI sẽ được mở trong một iframe với các tham số truy vấn courseId, itemId, itemType, attachmentIdsubmissionId được đặt. Đây cũng là submissionId được trả về trong trường AddOnContext.studentContext khi học viên xem tệp đính kèm. Nếu URI bị bỏ qua hoặc bị xoá, maxPoints cũng sẽ bị loại bỏ.

dueDate

object (Date)

Ngày đến hạn (theo giờ UTC) để hoàn thành công việc trên tệp đính kèm này. Bạn phải chỉ định thuộc tính này nếu đã chỉ định dueTime.

dueTime

object (TimeOfDay)

Thời gian trong ngày (theo giờ UTC) mà công việc trên tệp đính kèm này phải hoàn thành. Bạn phải chỉ định thuộc tính này nếu đã chỉ định dueDate.

maxPoints

number

Điểm tối đa cho tệp đính kèm này. Chỉ có thể đặt nếu bạn đặt studentWorkReviewUri. Đặt thành một giá trị khác 0 để cho biết tệp đính kèm hỗ trợ tính năng trả điểm về. Nếu được đặt, đây phải là một giá trị số nguyên không âm. Khi được đặt thành 0, tệp đính kèm sẽ không hỗ trợ tính năng chuyển điểm.

copyHistory[]

object (CopyHistory)

Chỉ có đầu ra. Giá trị nhận dạng của các tệp đính kèm từng là bản sao trước đó của tệp đính kèm này.

Nếu tệp đính kèm trước đó đã được sao chép do bài đăng mẹ của tệp đó được sao chép, thì thuộc tính này sẽ liệt kê giá trị nhận dạng của các tệp đính kèm là bản sao trước đó theo thứ tự thời gian tăng dần của bản sao.

EmbedUri

URI sẽ được tạo khung sau khi được điền sẵn các tham số truy vấn.

Biểu diễn dưới dạng JSON
{
  "uri": string
}
Trường
uri

string

Bắt buộc. URI sẽ được tạo khung sau khi được điền sẵn các tham số truy vấn. Đây phải là một chuỗi UTF-8 hợp lệ chứa từ 1 đến 1800 ký tự.

CopyHistory

Giá trị nhận dạng của một bản sao trước đó của một tệp đính kèm nhất định.

Biểu diễn dưới dạng JSON
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
Trường
courseId

string

Không thể thay đổi. Giá trị nhận dạng của khoá học.

postId
(deprecated)

string

Không thể thay đổi. Không dùng nữa, hãy sử dụng itemId.

itemId

string

Không thể thay đổi. Giá trị nhận dạng của Announcement, CourseWork hoặc CourseWorkMaterial trong đó tệp đính kèm được đính kèm.

attachmentId

string

Không thể thay đổi. Giá trị nhận dạng của tệp đính kèm.

Phương thức

create

Tạo tệp đính kèm có tiện ích bổ sung trong một bài đăng.

delete

Xoá tệp đính kèm của tiện ích bổ sung.

get

Trả về một tệp đính kèm có tiện ích bổ sung.

list

Trả về tất cả tệp đính kèm do một tiện ích bổ sung tạo trong bài đăng.

patch

Cập nhật tệp đính kèm của tiện ích bổ sung.