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 jeder Google Workspace for Education-Lizenzebene finden Sie auf der Vergleichsseite der Versionen.
Funktionen mit Teilnahmevoraussetzungen
Die folgenden Classroom API-Funktionen sind nur für berechtigte Nutzer verfügbar:
- Anhänge für Classroom-Add-ons erstellen und ändern
- Einstellungen für Benotungszeiträume ändern
- Benotungsgrundlagen erstellen, ändern 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 wissen 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 jedes Element den entsprechenden Capability an:
| Sie können prüfen, ob der Nutzer | Capability |
|---|---|
| Kann einen Classroom-Add-on-Anhang erstellen oder ändern, der mit dem Google Cloud-Projekt der OAuth-Client-ID verknüpft ist, die für die Anfrage verwendet wurde | CREATE_ADD_ON_ATTACHMENT |
| Kann die Einstellungen für Benotungszeiträume ändern | UPDATE_GRADING_PERIOD_SETTINGS |
| Kann Bewertungsschemata erstellen, ändern oder löschen | 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. Sie können dann im Namen des Nutzers API-Anfragen zu Capability stellen.