Method: courses.students.create

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

Quản trị viên miền được phép trực tiếp thêm 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 dùng mã đăng ký để tự thêm chính mình vào 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 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

Các tham số
courseId

string

Mã nhận dạng của khoá học mà bạn muốn 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

Các tham số
enrollmentCode

string

Mã đăng ký của khoá học để tạo học viên. Mã này là bắt buộc nếu userId tương ứng với người dùng yêu cầu; mã này có thể bị bỏ qua 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ể mới được tạo của Student.

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.