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 spełniające wymagania
Te funkcje interfejsu Classroom API są dostępne tylko dla kwalifikujących się użytkowników:
- Tworzenie załączników do dodatków do Classroom
- Zmienianie ustawień okresu oceniania
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 określić, czy użytkownik ma określone możliwości, wyślij żądanie do 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 ma dostęp do dodatku do Classroom należącego do projektu Google Cloud, który wysłał żądanie, prześlij wartość
CREATE_ADD_ON_ATTACHMENT. - Aby sprawdzić, czy użytkownik może modyfikować ustawienia okresu oceniania, prześlij
UPDATE_GRADING_PERIOD_SETTINGS.
Następnie sprawdź w odpowiedzi pole allowed. Jeśli allowed to true, użytkownik ma dostęp do wybranego Capability. Dzięki temu możesz wysyłać żądania do interfejsu API powiązane z elementem Capability w imieniu użytkownika.