Method: userProfiles.guardianInvitations.get

Restituisce un invito a un tutore specifico.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato a visualizzare gli inviti ai 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 né la stringa letterale me).
  • NOT_FOUND se Classroom non riesce a trovare alcun record dello studente in questione o invitationId. Può essere restituito anche se lo studente esiste, ma l'utente che effettua la richiesta non ha accesso per visualizzarlo.

Richiesta HTTP

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
studentId

string

L'ID dello studente di cui si richiede l'invito del tutore.
invitationId

string

Il campo id del GuardianInvitation richiesto.

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 GuardianInvitation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • 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.