Method: userProfiles.checkUserCapability

Gibt zurück, ob ein Nutzer die angegebene Classroom-Funktion verwenden darf. Mit diesem Endpunkt kann beispielsweise geprüft werden, ob ein Nutzer Add-on-Anhänge erstellen darf.

Ein anfragender Nutzer kann die Funktionen nur für sich selbst prüfen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, die Berechtigung für den angegebenen Nutzer zu prüfen.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.

HTTP-Anfrage

GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

Erforderlich. Kennung des Nutzers.

Wenn diese Kennzeichnung als Parameter einer Anfrage angegeben wird, kann sie einen der folgenden Werte haben:

  • Die numerische Kennung für den Nutzer
  • die E‑Mail-Adresse des Nutzers
  • das Stringliteral "me", das den anfragenden Nutzer angibt

Abfrageparameter

Parameter
capability

enum (Capability)

Erforderlich. Die Funktion, die für diesen Nutzer geprüft werden soll. Wenn Sie beispielsweise prüfen möchten, ob ein Nutzer eine Add-on-Anlage erstellen kann, legen Sie diesen Wert auf CREATE_ADD_ON_ATTACHMENT fest.
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Prüfung der Nutzerfunktionen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "capability": enum (Capability),
  "allowed": boolean
}
Felder
capability

enum (Capability)

Die Classroom-Funktion
allowed

boolean

Gibt an, ob die angegebene Funktion für den Nutzer zulässig ist.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.

Funktion

Enum-Wert, der die Funktion darstellt.

Enums
CAPABILITY_UNSPECIFIED Nicht unterstützt.
CREATE_ADD_ON_ATTACHMENT Die Möglichkeit, AddOnAttachments zu erstellen und zu ändern, die dem Developer Console-Projekt der OAuth-Client-ID zugeordnet sind, mit der die Anfrage gestellt wurde.
CREATE_RUBRIC Die Möglichkeit, Rubriken zu erstellen und zu bearbeiten.
UPDATE_GRADING_PERIOD_SETTINGS Die Möglichkeit, die Einstellungen für den Zeitraum der Notenvergabe zu ändern.
CREATE_STUDENT_GROUP Die Möglichkeit, Schülergruppen und ihre Mitglieder zu erstellen und zu ändern.