Method: courses.courseWorkMaterials.addOnAttachments.patch

Cập nhật một tệp đính kèm bằng tiện ích bổ sung.

Yêu cầu tiện ích bổ sung đó phải là tác giả ban đầu của tệp đính kèm.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED do lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • Giá trị là NOT_FOUND nếu một trong những tài nguyên đã xác định không tồn tại.

Yêu cầu HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
courseId

string

Bắt buộc. Giá trị nhận dạng của khoá học.
itemId

string

Mã nhận dạng của bài đăng có tệp đính kèm.
attachmentId

string

Bắt buộc. Giá trị nhận dạng của tệp đính kèm.

Tham số truy vấn

Các tham số
postId

string

Bắt buộc. Mã nhận dạng của bài đăng có tệp đính kèm.
updateMask

string (FieldMask format)

Bắt buộc. Mặt nạ giúp xác định các trường trên tệp đính kèm cần cập nhật. Quá trình cập nhật sẽ không thành công nếu bạn chỉ định các trường không hợp lệ. Nếu một trường hỗ trợ các giá trị trống, thì bạn có thể xoá trường đó bằng cách chỉ định trường đó trong mặt nạ cập nhật chứ không phải trong đối tượng AddOnAttachment. Nếu một trường không hỗ trợ các giá trị trống được đưa vào mặt nạ cập nhật và không được đặt trong đối tượng AddOnAttachment, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Giáo viên có thể chỉ định các trường sau đây:

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của AddOnAttachment.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của AddOnAttachment.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.addons.teacher

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.