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 đượ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ã nhận dạng được yêu cầu.
  • 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 có mặt nạ cập nhật nào được cung cấp.
  • 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

Tham 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

Tham số
updateMask

string (FieldMask format)

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

Khi được đặt trong 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.