Mặc dù mọi nhà phát triển đều có thể gửi yêu cầu đến API Lớp học của Google, nhưng một số tính năng của Lớp học của Google chỉ dành cho một số người dùng nhất định. Mỗi tính năng có thể có các yêu cầu khác nhau, chẳng hạn như phải có một loại giấy phép Google Workspace for Education nhất định. Để biết thông tin chi tiết về các tính năng ở từng cấp giấy phép Google Workspace for Education, hãy xem trang so sánh các phiên bản.
Các tính năng có điều kiện sử dụng
Các tính năng sau đây của API Lớp học chỉ dành cho người dùng đủ điều kiện:
- Tạo và sửa đổi tệp đính kèm tiện ích bổ sung của Lớp học.
- Sửa đổi chế độ cài đặt giai đoạn chấm điểm.
- Tạo, sửa đổi và xoá phiếu chấm điểm.
Xác định các chức năng của người dùng
Các yêu cầu gửi đến API Lớp học được thực hiện thay mặt cho từng người dùng. Do đó, bạn nên kiểm tra xem người dùng có các chức năng phù hợp hay không trước khi đưa ra các yêu cầu API có yêu cầu về điều kiện.
Để xác định xem người dùng có một chức năng cụ thể hay không, hãy gửi một yêu cầu API đến phương thức checkUserCapability. Thêm loại Capability phù hợp cho tính năng Lớp học mà bạn dự định sử dụng. Chỉ định Capability thích hợp cho từng tính năng:
| Để biết người dùng có... | Capability |
|---|---|
| Có thể tạo hoặc sửa đổi tệp đính kèm của tiện ích bổ sung Lớp học được liên kết với dự án trên Google Cloud của mã ứng dụng OAuth dùng để đưa ra yêu cầu | CREATE_ADD_ON_ATTACHMENT |
| Có thể sửa đổi chế độ cài đặt giai đoạn chấm điểm | UPDATE_GRADING_PERIOD_SETTINGS |
| Có thể tạo, sửa đổi hoặc xoá tiêu chí chấm điểm | CREATE_RUBRIC |
Tiếp theo, hãy kiểm tra trường allowed trong phản hồi. Nếu allowed là true, thì người dùng có quyền truy cập vào Capability đã chọn. Sau đó, bạn có thể đưa ra các yêu cầu API liên quan đến Capability thay mặt cho người dùng.