Method: userProfiles.guardianInvitations.create

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

Una volta accettato l'invito, il suo state diventerà COMPLETED e inizierà a ricevere notifiche per i tutori. Verrà inoltre creata una risorsa Guardian per rappresentare il tutore attivo.

L'oggetto request deve avere i campi studentId e invitedEmailAddress impostati. La mancata impostazione di questi campi o l'impostazione di altri campi 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 lo studente, se i tutori non sono abilitati per il dominio in questione o per altri errori di accesso.
• RESOURCE_EXHAUSTED se lo studente o il tutore ha superato il limite di collegamento dei 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 è valido, ma Classroom non ha dati su questo studente.
• ALREADY_EXISTS se esiste già un invito al tutore in attesa per lo studente e per il invitedEmailAddress fornito oppure se il invitedEmailAddress fornito corrisponde all'Account Google di un Guardian esistente per questo utente.