Method: courses.patch

Cập nhật một hoặc nhiều trường trong khoá học.

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

  • PERMISSION_DENIED nếu người dùng yêu cầu không được phép sửa đổi khoá học được yêu cầu hoặc đối với lỗi truy cập.
  • NOT_FOUND nếu không có khoá học nào có mã nhận dạng được yêu cầu.
  • INVALID_ARGUMENT nếu bạn chỉ định các trường không hợp lệ trong mặt nạ cập nhật hoặc nếu bạn không cung cấp mặt nạ cập nhật.
  • FAILED_PRECONDITION cho các lỗi yêu cầu sau đây:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
id

string

Giá trị nhận dạng của khoá học cần cập nhật. 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 alias.

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 trên khoá học. 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ệ. Các trường sau đây hợp lệ:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Lưu ý: các bản vá cho ownerId được coi là có hiệu lực ngay lập tức, nhưng trên thực tế, có thể mất một khoảng thời gian để hoàn tất việc chuyển quyền sở hữu của tất cả các tài nguyên bị ảnh hưởng.

Khi được đặt trong một tham số truy vấn, trường này phải được chỉ định là

updateMask=<field1>,<field2>,...

Đâ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"

Nội dung yêu cầu

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

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 Course.

Phạm vi uỷ quyền

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

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

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