Method: courses.patch

Cập nhật một hoặc nhiều trường trong một 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 đã yêu cầu hoặc do lỗi truy cập.
  • NOT_FOUND nếu không có khoá học nào có mã yêu cầu.
  • Là giá trị INVALID_ARGUMENT nếu các trường không hợp lệ được chỉ định trong mặt nạ cập nhật hoặc nếu không cung cấp mặt nạ cập nhật nào.
  • FAILED_PRECONDITION đối với các lỗi yêu cầu sau:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

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

Các tham số
id

string

Mã 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

Các tham số
updateMask

string (FieldMask format)

Mặt nạ giúp xác định những trường cần cập nhật trong khoá học. Đây là trường bắt buộc để 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 chút thời gian để chuyển quyền sở hữu tất cả tài nguyên bị ảnh hưởng hoàn tất.

Khi đặ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 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 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.