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

Mặc dù bất kỳ nhà phát triển nào cũng 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 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ư yêu cầu về 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ần đáp ứng điều kiện

Các tính năng sau đây của API Lớp học chỉ được cung cấp cho người dùng đủ điều kiện:

  • Tạo tệp đính kèm bằng 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

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 đủ điều kiện.

Để xác định xem người dùng có một khả năng cụ thể hay không, hãy gửi 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:

  • Để xem người dùng có quyền truy cập vào tiện ích bổ sung dành cho Lớp học thuộc dự án Google Cloud yêu cầu hay không, hãy truyền giá trị CREATE_ADD_ON_ATTACHMENT.
  • Để xem người dùng có thể sửa đổi chế độ cài đặt giai đoạn chấm điểm hay không, hãy truyền UPDATE_GRADING_PERIOD_SETTINGS.

Tiếp theo, hãy kiểm tra trường allowed trong phản hồi. Nếu allowedtrue, 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.