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 | |
---|---|
user |
Erforderlich. Kennung des Nutzers. Wenn diese Kennung als Parameter einer Anfrage angegeben wird, kann es sich um einen der folgenden Werte handeln:
|
Abfrageparameter
Parameter | |
---|---|
capability |
Erforderlich. Die Funktion, die für diesen Nutzer geprüft werden soll. Wenn Sie beispielsweise prüfen möchten, ob ein Nutzer einen Add-on-Anhang erstellen kann, legen Sie hier |
preview |
Optional. Die Vorabversion 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 ( |
Felder | |
---|---|
capability |
Die Classroom-Funktion. |
allowed |
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 Leitfaden zur Autorisierung.
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 mit dem Developer Console-Projekt der OAuth-Client-ID verknüpft sind, die für die Anfrage verwendet wurde. |
CREATE_RUBRIC |
Die Möglichkeit, Bewertungsraster zu erstellen und zu ändern. |
UPDATE_GRADING_PERIOD_SETTINGS |
Die Möglichkeit, die Einstellungen für die Benotungszeiträume zu ändern. |