Điều kiện đối với người dùng

Mặc dù mọi nhà phát triển đều có thể gửi yêu cầu đến API Google Lớp học, nhưng một số tính năng của Google Lớp học chỉ dành cho một số người dùng. 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.

Thuật ngữ chính: Người dùng đủ điều kiện có khả năng sử dụng một tính năng nhất định của Lớp học nếu họ đáp ứng các yêu cầu của tính năng đó.

Lưu ý quan trọng: Khả năng được xác định riêng cho từng người dùng và có thể thay đổi theo thời gian. Điều kiện sử dụng một số tính năng của API Lớp học có thể khác với các tính năng tương ứng trong ứng dụng Google Lớp học. Ví dụ: một số yêu cầu về giấy phép nhất định sẽ áp dụng khi tạo, sửa đổi hoặc xoá tiêu chí chấm điểm bằng API.

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 của 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á chấm điểm.

Xác định 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 yêu cầu API có các yêu cầu về điều kiện.

Lưu ý quan trọng: Hãy cân nhắc việc chủ động kiểm tra các chức năng của người dùng để bạn có thể điều chỉnh giao diện hoặc hành vi của sản phẩm cho phù hợp với các tính năng của Lớp học mà họ có thể truy cập.

Để xác định xem người dùng có một chức năng cụ thể hay không, hãy tạo một yêu cầu API cho 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:

Để xem 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 trong Lớp học được liên kết với dự án Google Cloud của mã ứng dụng khách 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ể thay mặt người dùng tạo các yêu cầu API liên quan đến Capability.

Lưu ý quan trọng: Ngay cả khi người dùng đủ điều kiện, các yêu cầu API phụ thuộc vào điều kiện này vẫn có thể không thành công. Tiêu chí sử dụng có nghĩa là người dùng có thể sử dụng một tính năng của Lớp học, chứ không phải một yêu cầu cụ thể sẽ thành công.