Gibt einen bestimmten Erziehungsberechtigten zurück.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn kein Nutzer, der mit dem angegebenenstudentId
übereinstimmt, für den anfragenden Nutzer sichtbar ist, wenn der anfragende Nutzer keine Angaben zu den Erziehungsberechtigten der durch diestudentId
angegebenen Schüler/Studenten sehen darf, wenn Erziehungsberechtigte nicht für die betreffende Domain aktiviert sind oder wenn andere Zugriffsfehler vorliegen.INVALID_ARGUMENT
, wenn einestudentId
angegeben ist, ihr Format jedoch nicht erkannt werden kann. Es handelt sich weder um eine E-Mail-Adresse noch um einestudentId
aus der API oder dem Literalstringme
.NOT_FOUND
, wenn der anfragende Nutzer berechtigt ist, Erziehungsberechtigte für den angefordertenstudentId
anzusehen, aber für diesen Schüler oder Studenten, der mit dem angegebenenguardianId
übereinstimmt, keinGuardian
-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 |
Der Schüler oder Studenten, dessen Erziehungsberechtigter angefragt wird. Beispiele:
|
guardianId |
Das Feld |
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.