REST Resource: courses.announcements.addOnAttachments

Tài nguyên: AddOnAttachment

Tiện ích bổ sung đính kèm trên 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

Bất biến. Giá trị nhận dạng của khoá học.

postId
(deprecated)

string

Bất biến. Không dùng nữa, hãy sử dụng itemId.

itemId

string

Bất biến. Giá trị nhận dạng của thông báo,courseWork hoặc mẫucourseWorkMaterial mà tệp đính kèm sẽ được đính kèm. Dành riêng cho mỗi khoá học.

id

string

Bất biến. Giá trị nhận dạng do lớp học gán cho tệp đính kèm này, giá trị duy nhấ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 dài từ 1 đến 1.000 ký tự.

teacherViewUri

object (EmbedUri)

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

studentViewUri

object (EmbedUri)

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

studentWorkReviewUri

object (EmbedUri)

URI để giáo viên xem bài tập của học viên đối với tệp đính kèm (nếu có). URI sẽ được mở trong iframe với các tham số truy vấn courseId, postId, attachmentIdsubmissionId đã được thiết lập. Đây cũng là submissionId do [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] trả về 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) cho bài tập 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) để xử lý tệp đính kèm này là đế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. Bạn chỉ có thể thiết lập nếu đã đặt studentWorkReviewUri. Hãy đặt một giá trị khác 0 để cho biết rằng tệp đính kèm có hỗ trợ trả điểm về. Nếu đặt, đây phải là một giá trị số nguyên không âm. Khi bạn đặt thành 0, tệp đính kèm sẽ không hỗ trợ trả điểm về.

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 đây 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 sao chép, phần này liệt kê số 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 sử dụng trong iframe sau khi được điền sẵn bằng 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 được sử dụng trong iframe sau khi được điền sẵn bằng các tham số truy vấn. Đây phải là một chuỗi UTF-8 hợp lệ có chứa từ 1 đến 1800 ký tự.

CopyHistory

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

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

string

Bất biến. Giá trị nhận dạng của khoá học.

postId
(deprecated)

string

Bất biến. Không dùng nữa, hãy sử dụng itemId.

itemId

string

Bất biến. Giá trị nhận dạng của thông báo,courseWork hoặc mẫucourseWorkMaterial mà tệp đính kèm sẽ được đính kèm.

attachmentId

string

Bất biến. 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 bằng tiện ích bổ sung dưới bài đăng.

delete

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

get

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

list

Trả về tất cả tệp đính kèm do 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.