Method: courses.create

Tạo một khoá học.

Người dùng được chỉ định trong ownerId là chủ sở hữu của khoá học đã tạo và được thêm làm giáo viên. Người dùng không phải là quản trị viên chỉ có thể tạo khoá học và tự làm chủ sở hữu. Quản trị viên miền có thể tạo các khoá học thuộc sở hữu của bất kỳ người dùng nào trong miền của họ.

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 tạo khoá học hoặc đối với lỗi truy cập.
  • NOT_FOUND nếu giáo viên chính không phải là người dùng hợp lệ.
  • FAILED_PRECONDITION nếu tài khoản của chủ sở hữu khoá học bị vô hiệu hoá hoặc đối với các lỗi yêu cầu sau đây:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS nếu bạn đã chỉ định một bí danh trong id và bí danh đó đã tồn tại.

Yêu cầu HTTP

POST https://classroom.googleapis.com/v1/courses

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

Tham số truy vấn

Thông số
previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của API. Bạn phải đặt giá trị này để truy cập vào các chức năng API mới được cung cấp cho nhà phát triển trong Chương trình dùng trước.

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 thực thể mới tạo 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.