Method: userProfiles.guardians.delete

Consente di eliminare un tutore.

Il tutore non riceverà più notifiche e non sarà più accessibile tramite l'API.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se nessun utente corrispondente al studentId fornito è visibile all'utente che effettua la richiesta, se l'utente che effettua la richiesta non è autorizzato a gestire i tutori per lo studente identificato dal studentId, se i tutori non sono abilitati per il dominio in questione o per altri errori di accesso.
  • INVALID_ARGUMENT se è specificato un studentId, ma il relativo formato non può essere riconosciuto (non è un indirizzo email né un studentId dell'API).
  • NOT_FOUND se l'utente che effettua la richiesta è autorizzato a modificare i tutori per il studentId richiesto, ma non esiste un record Guardian per lo studente con il guardianId fornito.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
studentId

string

Lo studente di cui deve essere eliminato il tutore. Il valore sarà uno dei seguenti:

  • l'identificatore numerico dell'utente
  • l'indirizzo email dell'utente
  • la stringa letterale "me", che indica l'utente che effettua la richiesta
guardianId

string

Il campo id di un Guardian.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.