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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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.