Học viên và giáo viên là các đối tượng ánh xạ cụ thể giữa hồ sơ người dùng và khoá học, thể hiện vai trò của người dùng đó trong khoá học. Các chỉ định học viên và giáo viên không mang tính toàn cầu: người dùng có thể được chỉ định làm giáo viên cho một khoá học và học viên trong một khoá học khác. Chỉ định "học viên" hoặc "giáo viên" thể hiện một nhóm quyền của một người dùng cụ thể trong một khoá học cụ thể.
- Học sinh
- Tài nguyên dành cho học viên đại diện cho người dùng đăng ký với tư cách là học viên trong một khoá học cụ thể. Học viên được phép xem thông tin chi tiết về khoá học và giáo viên của khoá học đó.
- Giáo viên
- Tài nguyên giáo viên đại diện cho người dùng giảng dạy một khoá học cụ thể. Giáo viên được phép xem và thay đổi thông tin chi tiết về khoá học, xem giáo viên và học viên, cũng như quản lý giáo viên và học viên khác.
Học viên và giáo viên được xác định theo mã nhận dạng hoặc địa chỉ email duy nhất của người dùng, do API Thư mục trả về.
Người dùng hiện tại cũng có thể tham chiếu đến mã nhận dạng của chính họ bằng cách viết tắt "me"
.
Thêm trực tiếp
Quản trị viên miền được phép bỏ qua luồng lời mời và trực tiếp thêm người dùng trong miền của họ với tư cách là giáo viên hoặc học viên vào các khóa học trong miền của họ. Một khoá học được xem là thuộc miền của quản trị viên nếu chủ sở hữu khoá học thuộc miền của quản trị viên. Đối với người dùng hoặc khoá học bên ngoài miền của quản trị viên miền đã được xác thực, ứng dụng phải có được sự đồng ý của người dùng bằng cách gửi lời mời sử dụng phương thức invitations.create()
.
Thêm hoặc xoá giáo viên
Quản trị viên miền có thể trực tiếp thêm giáo viên trong miền của họ vào các khoá học bằng teachers.create()
, như trong mẫu sau:
.NET
Java
1.199
Python
Nếu đang thêm giáo viên khác thay mặt cho một giáo viên đã được xác thực, bạn phải sử dụng phương thức invitations.create()
.
Bạn có thể xoá giáo viên khác khỏi khoá học bằng phương thức teachers.delete()
. Thao tác này chỉ xoá giáo viên đã chỉ định khỏi khoá học và không ảnh hưởng đến bài tập của giáo viên đó trong các khoá học khác hoặc hồ sơ người dùng của họ.
Đăng ký hoặc xoá học viên
Quản trị viên miền có thể trực tiếp thêm học viên trong miền của họ bằng phương thức
students.create()
, như trong mẫu sau:
.NET
Java
1.199
Python
Nếu đang thêm học viên thay mặt cho giáo viên đã được xác thực, bạn phải sử dụng phương thức invitations.create()
.
Bạn có thể xoá học viên khỏi khoá học bằng phương thức students.delete()
. Thao tác này chỉ xoá học viên được chỉ định khỏi khoá học và không ảnh hưởng đến trạng thái đăng ký tham gia các khoá học khác hoặc hồ sơ người dùng của học viên đó.
Truy xuất các khoá học của người dùng
Để truy xuất danh sách các khoá học cho học viên hoặc giáo viên, hãy gọi courses.list()
và cung cấp studentId
hoặc teacherId
của người dùng tương ứng.
Truy xuất hồ sơ của người dùng
Để truy xuất hồ sơ rút gọn (bao gồm cả mã nhận dạng và tên) của một người dùng, hãy gọi userProfiles.get()
bằng mã nhận dạng, email hoặc "tôi" của người dùng gửi yêu cầu.
Để truy xuất trường emailAddress
, bạn phải bao gồm phạm vi classroom.profile.emails
.
Mã nhận dạng được trả về tương ứng với tài nguyên Người dùng API Thư mục chứa studentId
hoặc teacherId
trùng khớp.
Quản lý chủ sở hữu khoá học
Quản trị viên miền có thể chuyển quyền sở hữu khoá học giữa các giáo viên. Vui lòng xem phần Chuyển quyền sở hữu khoá học để biết thông tin chi tiết quan trọng.