Kto może skorzystać z oferty

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.

Kluczowe pojęcie: Uprawniony użytkownik ma możliwość korzystania z określonej funkcji Classroom, jeśli spełnia jej wymagania.

Kluczowa informacja: możliwość jest określana oddzielnie dla każdego użytkownika i może się zmieniać z czasem. Kwalifikacje do korzystania z niektórych funkcji interfejsu Classroom API mogą się różnić od kwalifikacji do korzystania z odpowiednich funkcji w aplikacji Google Classroom. Na przykład podczas tworzenia, modyfikowania lub usuwania rubryk za pomocą interfejsu API obowiązują określone wymagania dotyczące licencji.

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.

Ważna uwaga: warto sprawdzać możliwości użytkowników, aby dostosowywać wygląd lub działanie produktu do funkcji Classroom, do których mają dostęp.

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.

Ważne: nawet jeśli użytkownik spełnia wymagania, żądania interfejsu API, które zależą od spełnienia tych wymagań, mogą się nie powieść. Kwalifikowanie się oznacza, że użytkownik może korzystać z funkcji Classroom, a nie że konkretne żądanie zakończy się powodzeniem.