Method: userProfiles.guardians.delete

Löscht einen Erziehungsberechtigten.

Der Erziehungsberechtigte erhält keine Benachrichtigungen mehr und der Erziehungsberechtigte kann nicht mehr über die API aufgerufen werden.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn kein Nutzer, der mit der angegebenen studentId übereinstimmt, für den anfragenden Nutzer sichtbar ist, wenn er nicht berechtigt ist, die Erziehungsberechtigten für den in der studentId angegebenen Schüler zu verwalten, wenn keine Erziehungsberechtigten für die betreffende Domain aktiviert sind oder andere Zugriffsfehler vorliegen.
  • INVALID_ARGUMENT, wenn eine studentId angegeben ist, ihr Format jedoch nicht erkannt werden kann (es ist weder eine E-Mail-Adresse noch ein studentId von der API).
  • NOT_FOUND, wenn der anfragende Nutzer berechtigt ist, die Erziehungsberechtigten für die angeforderte studentId zu ändern, aber für diesen Schüler/Studenten mit der angegebenen guardianId kein Guardian-Datensatz vorhanden ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
studentId

string

Der Schüler, dessen Erziehungsberechtigter gelöscht werden soll Eines der folgenden Betriebssysteme:

  • Numerische Kennung des Nutzers
  • die E-Mail-Adresse des Nutzers
  • das String-Literal "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 ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.