Method: courses.courseWorkMaterials.patch

Cập nhật một hoặc nhiều trường của tài liệu bài tập trên lớp.

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

  • PERMISSION_DENIED nếu dự án của nhà phát triển yêu cầu quyền truy cập gặp lỗi.
  • INVALID_ARGUMENT nếu yêu cầu có định dạng không chính xác.
  • FAILED_PRECONDITION nếu tài liệu bài tập được yêu cầu đã bị xoá.
  • NOT_FOUND nếu tài liệu được yêu cầu của khoá học hoặc bài tập trên lớp không tồn tại

Yêu cầu HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{id}

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

Tham số đường dẫn

Thông số
courseId

string

Giá trị nhận dạng của khoá học. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc một alias.
id

string

Giá trị nhận dạng của tài liệu bài tập trong khoá học.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Mặt nạ xác định những trường cần cập nhật trong tài liệu bài tập trên lớp. Bạn phải điền thông tin vào trường này để 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ợ 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 và không chỉ định trong đối tượng tài liệu bài tập. Nếu một trường không hỗ trợ giá trị trống có trong mặt nạ cập nhật và không được đặt trong đối tượng tài liệu bài tập trên lớp, thì lỗi INVALID_ARGUMENT sẽ được trả về.

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của điểm cuối.

PREVIEW_VERSION_9001 bao gồm các chức năng mới: * Hỗ trợ cập nhật cho các thành phần. Để cập nhật tài liệu, hãy sử dụng updateMask "materials". Danh sách tài liệu được cung cấp trong đối tượng CourseWorkMaterial của yêu cầu sẽ thay thế hoàn toàn danh sách hiện có. Bạn có thể xoá trường materials bằng cách chỉ định "materials" trong mặt nạ cập nhật và không chỉ định trong đối tượng CourseWorkMaterial. Hiện tại, chúng tôi không hỗ trợ việc cập nhật trạng thái ĐÃ XUẤT BẢN CourseWorkMaterial.

Nội dung yêu cầu

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

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 thực thể của CourseWorkMaterial.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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