REST Resource: courses.posts.addOnAttachments

Tài nguyên: AddOnAttachment

Tệp đính kèm của tiện ích bổ sung trong 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)
    }
  ],
  "gradeSyncEnabled": boolean
}
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 mà tệp đính kèm được đính kèm. Mỗi khoá học có một mã nhận dạng duy nhất.

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, riêng biệt cho mỗi bài đă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 có đặt các tham số truy vấn courseId, itemId, itemType và attachmentId.

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 có đặt các tham số truy vấn courseId, itemId, itemType và attachmentId.

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 có đặt các tham số truy vấn courseId, itemId, itemType, attachmentId và submissionId. Đây là cùng một 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á, thì maxPoints cũng sẽ bị loại bỏ.

dueDate

object (Date)

Ngày đến hạn nộp bài tập đính kèm này, theo giờ UTC. 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à bài tập trong tệp đính kèm này đến hạn. 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ả về điểm. Nếu được đặt, thì đâ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 trả lại điểm.

copyHistory[]

object (CopyHistory)

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

Nếu tệp đính kèm đã được sao chép trước đó do bài đăng gốc của tệp đính kèm đó được sao chép, thì trường 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 đó của tệp đính kèm này theo thứ tự thời gian sao chép tăng dần.

gradeSyncEnabled

boolean

Chỉ có đầu ra. Liệu các thay đổi đối với giá trị pointsEarned trên student submissions của tệp đính kèm này có được sao chép vào trường pointsEarned trên CourseWork submissions của học viên hay không. Trường này có thể là true cho tối đa một tệp đính kèm của tiện ích bổ sung trên mỗi mục trong luồng.

Phương thức

create

Tạo tệp đính kèm của 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.