Method: courses.students.create

Thêm người dùng làm học viên của một khoá học.

Quản trị viên miền được phép thêm trực tiếp người dùng trong miền của họ làm học viên vào các khoá học trong miền của họ. Học viên được phép tự thêm mình vào một khoá học bằng mã đăng ký.

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 học viên trong khoá học này hoặc do lỗi truy cập.
  • NOT_FOUND nếu mã khoá học được yêu cầu không tồn tại.
  • FAILED_PRECONDITION nếu tài khoản của người dùng được yêu cầu bị vô hiệu hoá, đối với các lỗi yêu cầu sau:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS nếu người dùng đã là học viên hoặc giáo viên trong khoá học.

Yêu cầu HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

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 để tạo học viên. 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ố
enrollmentCode

string

Mã đăng ký của khoá học để tạo học viên. Bạn bắt buộc phải có mã này nếu userId tương ứng với người dùng yêu cầu; bạn có thể bỏ qua mã này nếu người dùng yêu cầu có quyền quản trị để tạo học viên cho bất kỳ người dùng nào.

Nội dung yêu cầu

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

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

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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