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à học viên trong một khoá học khác. Chỉ định "học viên" hoặc "giáo viên" là một nhóm quyền của 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êntrong 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ý giáo viên và học viên khác. Mỗi khoá học đều 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 thêm hoặc xoá người dùng khỏi các khoá học trực tiếp 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 một khoá học nếu đáp ứng các điều kiện sau:
- Người dùng được thêm là một phần trong 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 bên ngoài miền của quản trị viên, các ứ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 riêng biệt của khoá học có trong tài nguyên Course. Trong ứng dụng Lớp học trên web, biểu tượng enrollmentCode có trong thẻ bảng tin và trang thông tin chi tiết 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 vào khoá học.
Bảng sau đây mô tả người dùng nào được phép đưa ra yêu cầu đối với các phương thức create và delete cho các 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 một 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:
.NET
Java
PHP
Python
Người cùng dạy 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 được chỉ định khỏi khoá học và không ảnh hưởng đến việc giao bài tập của họ 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.
.NET
Java
PHP
Python
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 được chỉ định và không ảnh hưởng đến việc đăng ký của họ trong các khoá học khác hoặc hồ sơ người dùng của họ.
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 một học viên hoặc giáo viên, hãy gọi courses.list và cung cấp studentId hoặc teacherId tương ứng của người dùng.
Bạn không thể đặt cả studentId và teacherId trong một yêu cầu courses.list() duy nhất. Để truy xuất danh sách các khoá học mà một giáo viên và học viên cụ thể đã đăng ký, hãy đưa ra các yêu cầu courses.list() riêng cho từng người dùng. Sau đó, tìm giao điểm của hai tập hợp kết quả.
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 cho người dùng yêu cầu. Để truy xuất trường emailAddress, bạn phải thêm phạm vi classroom.profile.emails.
id được trả về tương ứng với tài nguyên Người dùng của Directory API chứa studentId hoặc teacherId phù hợp.