Vai trò của học viên và giáo viên trong Google Lớp học thể hiện vai trò của người dùng trong một khoá học. Một người dùng có thể được chỉ định làm giáo viên trong một khoá học và làm học viên trong một khoá học khác. Chức danh "học viên" hoặc "giáo viên" đại diện cho một nhóm quyền cho một người dùng cụ thể trong một khoá học cụ thể.
- Sinh viên
- Tài nguyên
Student
đại diện cho một người dùng đăng ký làm 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
Teacher
đại diện cho một người dù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ý các giáo viên và học viên khác. Mỗi khoá học có một giáo viên chính hoặc chủ sở hữu khoá học. Đây là giáo viên có thể quản lý các chế độ cài đặt như chuyển quyền sở hữu khoá học.
Học viên và giáo viên được xác định bằng mã nhận dạng duy nhất hoặc địa chỉ email của người dùng, do Directory API 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 riêng họ bằng cách sử dụng ký hiệu viết tắt "me"
.
Quyền quản lý trực tiếp bằng API Lớp học
Quản trị viên, học viên và giáo viên có các quyền khác nhau khi trực tiếp thêm hoặc xoá người dùng khỏi khoá học bằng API Lớp học.
Quản trị viên
Quản trị viên miền được phép bỏ qua quy trình mời và trực tiếp thêm học viên và giáo viên vào khoá học nếu đáp ứng các điều kiện sau:
- Người dùng mà bạn đang thêm thuộc miền của quản trị viên.
- Giáo viên chính của khoá học hoặc 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 nằm ngoài miền của quản trị viên, ứng dụng phải nhận được sự đồng ý của người dùng bằng cách gửi lời mời bằng phương thức invitations.create()
.
Sinh viên
Học viên có thể tự thêm mình vào một khoá học bằng cách gọi students.create()
và chỉ định enrollmentCode
của khoá học. enrollmentCode
là giá trị nhận dạng duy nhất của khoá học có trong tài nguyên Course
. Trong ứng dụng web của Lớp học, enrollmentCode
có trong thẻ luồng và trang chi tiết về khoá học.
Giáo viên
Giáo viên không thể trực tiếp thêm người dùng vào khoá học và phải sử dụng phương thức invitations.create()
để mời học viên và giáo viên khác tham gia khoá học.
Bảng sau đây mô tả người dùng nào được phép gửi yêu cầu đến các phương thức create
và delete
cho tài nguyên Teacher
và Student
.
Quản trị viên | Giáo viên | Sinh viên | |
---|---|---|---|
CreateTeacher |
✔️ | ✖️ | ✖️ |
DeleteTeacher |
✔️ | ✔️ | ✖️ |
CreateStudent |
✔️ | ✖️ | ✔️ 1 |
DeleteStudent |
✔️ | ✔️ | ✔️ 2 |
1 Học viên chỉ có thể tự thêm mình vào khoá học.
2 Học viên chỉ có thể tự xoá mình khỏi một khoá học.
Quản lý 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:
Người cùng dạy có thể xoá các 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 việc chỉ định giáo viên đó cho các khoá học khác hoặc hồ sơ người dùng của họ.
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. Hãy xem phần Cập nhật chủ sở hữu khoá học để biết thông tin chi tiết quan trọng.
Quản lý 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()
. Nếu học viên tự thêm mình vào một khoá học, thì bạn phải có enrollmentCode
.
Việc xoá học viên khỏi một khoá học bằng phương thức students.delete()
chỉ xoá học viên khỏi khoá học đã chỉ định và không ảnh hưởng đến việc đăng ký khoá học khác hoặc hồ sơ người dùng của học viên.
Truy xuất 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ơ của một người dùng, bao gồm cả mã nhận dạng và tên, hãy gọi userProfiles.get()
bằng mã nhận dạng, email hoặc "tôi" của người dùng yêu cầu. Để truy xuất trường emailAddress
, bạn phải đưa phạm vi classroom.profile.emails
vào.
id
đượ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
khớp.