Method: userProfiles.guardians.delete

Elimina un tutore.

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

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se nessun utente che corrisponde al studentId fornito è visibile all'utente richiedente, se quest'ultimo 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 viene specificato un studentId, ma il suo formato non è riconosciuto (non è un indirizzo email, né un studentId dall'API).
  • NOT_FOUND se l'utente che ha inviato la richiesta è autorizzato a modificare i tutori per il studentId richiesto, ma non esiste un record Guardian per quello studente con il valore 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
  • Il valore letterale della stringa "me", che indica l'utente che ha inviato la richiesta
guardianId

string

Il campo id da 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 alle autorizzazioni.