Każdy deweloper może wysyłać żądania do interfejsu Google Classroom API, ale niektóre funkcje Google Classroom są dostępne tylko dla określonych użytkowników. Każda funkcja może mieć inne wymagania, np. wymagać określonego typu licencji Google Workspace for Education. Szczegółowe informacje o funkcjach w ramach poszczególnych poziomów licencji Google Workspace for Education znajdziesz na stronie z porównaniem wersji.
Funkcje z wymaganiami
Te funkcje interfejsu Classroom API są dostępne tylko dla kwalifikujących się użytkowników:
- tworzenie i modyfikowanie załączników dodatków do Classroom.
- modyfikowanie ustawień okresu oceniania.
- tworzenie, modyfikowanie i usuwanie kryteriów.
Określanie możliwości użytkowników
Żądania do interfejsu Classroom API są wysyłane w imieniu poszczególnych użytkowników. Dlatego przed wysłaniem żądań interfejsu API z wymaganiami dotyczącymi kwalifikowania się sprawdź, czy użytkownik ma odpowiednie możliwości.
Aby sprawdzić, czy użytkownik ma daną funkcję, wyślij żądanie interfejsu API do metody checkUserCapability. Uwzględnij odpowiedni typ Capability dla funkcji Classroom, której chcesz użyć. Określ odpowiednie Capability dla każdej funkcji:
| Aby sprawdzić, czy użytkownik | Capability |
|---|---|
| Może tworzyć lub modyfikować załącznik dodatku Classroom powiązany z projektem Google Cloud identyfikatora klienta OAuth użytego do wysłania żądania. | CREATE_ADD_ON_ATTACHMENT |
| mogą modyfikować ustawienia okresu oceniania; | UPDATE_GRADING_PERIOD_SETTINGS |
| Może tworzyć, modyfikować i usuwać oceny cząstkowej. | CREATE_RUBRIC |
Następnie sprawdź pole allowed w odpowiedzi. Jeśli allowed ma wartość true, użytkownik ma dostęp do wybranego Capability. Następnie możesz wysyłać w imieniu użytkownika żądania API dotyczące Capability.