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 eines bestimmten Google Workspace for Education-Lizenztyps. Eine detaillierte Aufschlüsselung der Funktionen auf den einzelnen Lizenzebenen von Google Workspace for Education finden Sie auf der Seite mit den Versionsvergleichen.
Funktionen mit Teilnahmevoraussetzungen
Die folgenden Classroom API-Funktionen sind nur für berechtigte Nutzer verfügbar:
- Anhänge für Classroom-Add-ons erstellen
- Einstellungen für Benotungszeiträume ändern
- Bewertungsschemata erstellen, aktualisieren und löschen
Nutzerfunktionen ermitteln
Anfragen an die Classroom API werden im Namen einzelner Nutzer gesendet. 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. Geben Sie den entsprechenden Capability-Typ für die Classroom-Funktion an, die Sie verwenden möchten. Geben Sie für jede Funktion den entsprechenden Capability an:
| Wenn der Nutzer | Capability |
|---|---|
| Zugriff auf ein Classroom-Add-on hat, das dem anfragenden Google Cloud-Projekt gehört | CREATE_ADD_ON_ATTACHMENT |
| Kann Einstellungen für Benotungszeiträume ändern | UPDATE_GRADING_PERIOD_SETTINGS |
| Kann Bewertungsschemata erstellen oder ändern | CREATE_RUBRIC |
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.