Method: userProfiles.guardianInvitations.get

Restituisce un invito specifico come tutore.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente richiedente non è autorizzato a visualizzare gli inviti dei 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, né la stringa letterale me).
  • NOT_FOUND se Classroom non riesce a trovare alcun record dello studente specificato o di invitationId. Possono essere restituiti anche se lo studente esiste, ma l'utente che ha inviato la richiesta non ha accesso alla visualizzazione dello studente.

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 viene richiesto l'invito come tutore.
invitationId

string

Il campo id della GuardianInvitation richiesta.

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 alle autorizzazioni.