Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

Method: userProfiles.guardians.get

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Gibt einen bestimmten Erziehungsberechtigten zurück.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn kein Nutzer, der mit dem angegebenen studentId übereinstimmt, für den anfragenden Nutzer sichtbar ist, wenn der anfragende Nutzer keine Angaben zu den Erziehungsberechtigten der durch die studentId angegebenen Schüler/Studenten sehen darf, wenn Erziehungsberechtigte nicht für die betreffende Domain aktiviert sind oder wenn andere Zugriffsfehler vorliegen.
  • INVALID_ARGUMENT, wenn eine studentId angegeben ist, ihr Format jedoch nicht erkannt werden kann. Es handelt sich weder um eine E-Mail-Adresse noch um eine studentId aus der API oder dem Literalstring me.
  • NOT_FOUND, wenn der anfragende Nutzer berechtigt ist, Erziehungsberechtigte für den angeforderten studentId anzusehen, aber für diesen Schüler oder Studenten, der mit dem angegebenen guardianId übereinstimmt, kein Guardian-Eintrag vorhanden ist.

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 Schüler oder Studenten, dessen Erziehungsberechtigter angefragt 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 einem 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 Übersicht zu OAuth 2.0.