Method: userProfiles.guardianInvitations.create

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

Una volta che il tutore accetta l'invito, il suo state cambierà in COMPLETED e inizierà a ricevere le notifiche per il tutore. Verrà creata anche una risorsa Guardian per rappresentare il tutore attivo.

Per l'oggetto di richiesta devono essere impostati i campi studentId e invitedEmailAddress. La mancata impostazione di questi campi o l'impostazione di qualsiasi altro campo nella richiesta comporterà un errore.

Questo metodo restituisce i seguenti codici di errore:

• PERMISSION_DENIED se l'utente corrente non dispone dell'autorizzazione per gestire i tutori, se il tutore in questione ha già rifiutato troppe richieste per quello studente, se i tutori non sono abilitati per il dominio in questione o se si verificano altri errori di accesso.
• RESOURCE_EXHAUSTED se lo studente o il tutore ha superato il limite di link per i tutori.
• INVALID_ARGUMENT se l'indirizzo email del tutore non è valido (ad esempio, se è troppo lungo) o se non è possibile riconoscere il formato dell'ID studente fornito (non è un indirizzo email, né un userId di questa API). Questo errore viene restituito anche se sono impostati campi di sola lettura o se il campo state è impostato su un valore diverso da PENDING.
• NOT_FOUND se l'ID studente fornito è un ID studente valido, ma in Classroom non è presente alcuna informazione relativa allo studente.
• ALREADY_EXISTS se è già presente un invito in attesa come tutore per lo studente e invitedEmailAddress fornito o se il valore invitedEmailAddress fornito corrisponde all'Account Google di un Guardian esistente per questo utente.