Method: userProfiles.guardians.delete

Supprime un représentant légal.

Le tuteur ne recevra plus de notifications et ne pourra plus y accéder via l'API.

Cette méthode renvoie les codes d'erreur suivants:

  • PERMISSION_DENIED si aucun utilisateur correspondant au studentId fourni n'est visible pour l'utilisateur à l'origine de la demande, si celui-ci n'est pas autorisé à gérer les représentants légaux de l'élève identifié par le studentId ou si les représentants légaux ne sont pas activés pour le domaine en question, ou en cas d'erreur d'accès.
  • INVALID_ARGUMENT si un studentId est spécifié, mais que son format n'est pas reconnu (il ne s'agit pas d'une adresse e-mail, ni d'un studentId de l'API).
  • NOT_FOUND si l'utilisateur à l'origine de la demande est autorisé à modifier les représentants légaux du studentId demandé, mais qu'aucun enregistrement Guardian n'existe pour cet élève avec le guardianId fourni.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
studentId

string

Élève dont le représentant légal doit être supprimé. Choisissez l'une des options suivantes :

  • l'identifiant numérique de l'utilisateur
  • l'adresse e-mail de l'utilisateur ;
  • Le littéral de chaîne "me", indiquant l'utilisateur à l'origine de la demande
guardianId

string

Le champ id issu d'un Guardian.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le guide relatif aux autorisations.