Method: userProfiles.guardians.get

Restituisce un tutore specifico.

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 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 viene specificato un studentId, ma il suo formato non è riconosciuto (non è un indirizzo email, né un studentId dall'API, né la stringa letterale me).
  • NOT_FOUND se l'utente che ha inviato la richiesta è autorizzato a visualizzare i tutori per il studentId richiesto, ma non esiste un record Guardian per lo studente corrispondente al valore 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 richiesto 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 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 alle autorizzazioni.