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. określony typ licencji Google Workspace for Education. Szczegółowe informacje o funkcjach dostępnych na poszczególnych poziomach licencji Google Workspace for Education znajdziesz na stronie porównania wersji.
Funkcje z wymaganiami
Poniższe funkcje interfejsu Classroom API są dostępne tylko dla uprawnionych użytkowników:
- Tworzenie i modyfikowanie załączników dodatków do Classroom.
- Modyfikowanie ustawień okresu oceniania.
- tworzenie, modyfikowanie i usuwanie kryteriów oceniania;
Określanie możliwości użytkownika
Żądania do interfejsu API Classroom są wysyłane w imieniu poszczególnych użytkowników. Dlatego przed wysłaniem żądań do interfejsu API z wymaganiami dotyczącymi uprawnień należy sprawdzić, czy użytkownik ma odpowiednie możliwości.
Aby sprawdzić, czy użytkownik ma określone uprawnienia, wyślij żądanie API do metody checkUserCapability. Uwzględnij odpowiedni typ Capability funkcji Classroom, której chcesz użyć. Określ odpowiedni atrybut Capability dla każdej cechy:
| Aby sprawdzić, czy użytkownik… | Capability |
|---|---|
| Może tworzyć lub modyfikować załącznik dodatku do 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ąstkowe. | CREATE_RUBRIC |
Następnie sprawdź pole allowed w odpowiedzi. Jeśli wartość allowed to true, użytkownik ma dostęp do wybranego Capability. Następnie możesz wysyłać żądania do interfejsu API
związane z Capability w imieniu użytkownika.