REST Resource: userProfiles.guardianInvitations

Risorsa: GuardianInvitation

Un invito a diventare il tutore di un utente specificato, inviato a un indirizzo email specificato.

Rappresentazione JSON
{
  "studentId": string,
  "invitationId": string,
  "invitedEmailAddress": string,
  "state": enum (GuardianInvitationState),
  "creationTime": string
}
Campi
studentId

string

ID dello studente (in formato standard)

invitationId

string

Identificatore univoco per questo invito.

Sola lettura.

invitedEmailAddress

string

Indirizzo email a cui è stato inviato l'invito. Questo campo è visibile solo agli amministratori di dominio.

state

enum (GuardianInvitationState)

Lo stato dell'invito.

creationTime

string (Timestamp format)

L'ora in cui è stato creato questo invito.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

GuardianInvitationState

Stato di un invito al tutore.

Enum
GUARDIAN_INVITATION_STATE_UNSPECIFIED Non deve mai essere restituito.
PENDING L'invito è attivo e in attesa di una risposta.
COMPLETE L'invito non è più attivo. Potrebbe essere stato accettato, rifiutato, ritirato o potrebbe essere scaduto.

Metodi

create

Crea un invito al tutore e invia un'email al tutore chiedendo di confermare di essere il tutore dello studente.

get

Restituisce un invito a un tutore specifico.

list

Restituisce un elenco di inviti per i tutori che l'utente che effettua la richiesta può visualizzare, filtrato in base ai parametri forniti.

patch

Modifica un invito al tutore.