Jeder Entwickler kann Anfragen an die Google Classroom API senden. Einige Google Classroom-Funktionen sind jedoch nur für bestimmte Nutzer verfügbar. Für jede Funktion können unterschiedliche Anforderungen gelten, z. B. die Notwendigkeit einer bestimmten Google Workspace for Education-Lizenz. Eine detaillierte Aufschlüsselung der Funktionen auf den einzelnen Lizenzebenen von Google Workspace for Education finden Sie auf der Seite mit den Versionsvergleichen.
Funktionen, für die bestimmte Voraussetzungen erfüllt sind
Die folgenden Classroom API-Funktionen sind nur für berechtigte Nutzer verfügbar:
Nutzungsmöglichkeiten ermitteln
Anfragen an die Classroom API werden im Namen einzelner Nutzer gestellt. Daher sollten Sie prüfen, ob ein Nutzer die entsprechenden Berechtigungen hat, bevor Sie API-Anfragen mit Berechtigungsanforderungen senden.
Wenn du feststellen möchtest, ob ein Nutzer eine bestimmte Funktion hat, sende eine API-Anfrage an die Methode checkUserCapability. Fügen Sie den entsprechenden Capability-Typ für die Classroom-Funktion ein, die Sie verwenden möchten. Geben Sie für jede Funktion den entsprechenden Capability an:
- Wenn Sie prüfen möchten, ob der Nutzer Zugriff auf ein Classroom-Add-on hat, das dem anfragenden Google Cloud-Projekt gehört, geben Sie den Wert
CREATE_ADD_ON_ATTACHMENTan. - Um zu sehen, ob der Nutzer die Einstellungen für die Benotungszeiträume ändern kann, übergeben Sie die
UPDATE_GRADING_PERIOD_SETTINGS.
Prüfen Sie als Nächstes das Feld allowed in der Antwort. Wenn allowed den Wert true hat, hat der Nutzer Zugriff auf die ausgewählte Capability. Du kannst dann im Namen des Nutzers API-Anfragen zu Capability stellen.