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, takie jak posiadanie określonego typu licencji Google Workspace for Education. Szczegółowe informacje o funkcjach dostępnych na poszczególnych poziomach 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 załączników dodatku do Classroom
- Modyfikowanie ustawień okresu oceniania
- Tworzenie, aktualizowanie i usuwanie ocen cząstkowych
Określanie możliwości użytkownika
Żą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 uprawnienia.
Aby sprawdzić, czy użytkownik ma określone uprawnienia, 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 cechy:
| Aby sprawdzić, czy użytkownik | Capability |
|---|---|
| ma dostęp do dodatku Classroom należącego do projektu Google Cloud, który wysłał żądanie; | CREATE_ADD_ON_ATTACHMENT |
| Może modyfikować ustawienia okresu oceniania | UPDATE_GRADING_PERIOD_SETTINGS |
| Może tworzyć i modyfikować ściągę | CREATE_RUBRIC |
Następnie sprawdź w odpowiedzi pole allowed. Jeśli allowed ma wartość true, użytkownik ma dostęp do wybranego elementu Capability. Następnie możesz wysyłać w imieniu użytkownika żądania interfejsu API dotyczące Capability.