Verwenden Ihre Nutzer Classroom mit Google Meet? Weitere Informationen finden Sie unter Apps Script – Kurzanleitung.

Method: userProfiles.guardians.get

Gibt einen bestimmten Erziehungsberechtigten zurück.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED wenn kein Nutzer, der mit den angegebenen studentId übereinstimmt, für den anfragenden Nutzer sichtbar ist, wenn der anfragende Nutzer keine Informationen zu Erziehungsberechtigten für den Schüler oder Studenten sehen darf, der vom studentId identifiziert wurde, und wenn Erziehungsberechtigte nicht aktiviert sind für Die Domain oder für andere Zugriffsfehler.
  • INVALID_ARGUMENT, wenn ein studentId angegeben wird, sein Format jedoch nicht erkannt wird (es ist weder eine E-Mail-Adresse noch ein studentId-Wert aus der API oder der Literalstring me).
  • NOT_FOUND, wenn der anfragende Nutzer Erziehungsberechtigte für den angeforderten studentId sehen darf, aber für den Kursteilnehmer kein Guardian-Eintrag vorhanden ist, der dem angegebenen guardianId entspricht.

HTTP-Anfrage

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
studentId

string

Der Kursteilnehmer, dessen Erziehungsberechtigter angefordert wird. Beispiele:

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

string

Das Feld id aus einer Guardian.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Guardian.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
  • https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
  • https://www.googleapis.com/auth/classroom.guardianlinks.students

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.