Method: userProfiles.guardians.get

Restituisce un tutore specifico.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se nessun utente corrisponde al studentId fornito è visibile all'utente che effettua la richiesta, se l'utente che effettua la richiesta non è autorizzato a visualizzare le informazioni sul tutore dello 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 né la stringa letterale me).
  • NOT_FOUND se l'utente che effettua la richiesta è autorizzato a visualizzare i tutori per il studentId richiesto, ma non esiste alcun record Guardian per lo studente che corrisponda al guardianId fornito.

Richiesta HTTP

GET 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 viene richiesta la presenza del 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 contiene un'istanza di Guardian.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.