Method: userProfiles.guardianInvitations.create

Cria um convite para o responsável e envia um e-mail pedindo que ele confirme que é o responsável pelo estudante.

Quando o responsável aceitar o convite, o state vai mudar para COMPLETED, e ele vai começar a receber notificações de responsável. Um recurso Guardian também será criado para representar o responsável ativo.

O objeto de solicitação precisa ter os campos studentId e invitedEmailAddress definidos. A falha na configuração desses campos ou a configuração de outros campos na solicitação resultará em um erro.

Esse método retorna os seguintes códigos de erro:

• PERMISSION_DENIED se o usuário atual não tiver permissão para gerenciar responsáveis, se o responsável em questão já tiver rejeitado muitas solicitações para esse estudante, se os responsáveis não estiverem ativados para o domínio em questão ou por outros erros de acesso.
• RESOURCE_EXHAUSTED se o estudante ou responsável tiver excedido o limite de vinculação.
• INVALID_ARGUMENT se o endereço de e-mail do responsável não for válido (por exemplo, se for muito longo) ou se o formato do ID do estudante fornecido não puder ser reconhecido (não é um endereço de e-mail nem um userId desta API). Esse erro também será retornado se campos somente leitura forem definidos ou se o campo state for definido como um valor diferente de PENDING.
• NOT_FOUND se o ID do estudante fornecido for válido, mas o Google Sala de Aula não tiver registro desse estudante.
• ALREADY_EXISTS se já houver um convite pendente para o responsável do estudante e o invitedEmailAddress fornecido ou se o invitedEmailAddress fornecido corresponder à conta do Google de um Guardian existente para esse usuário.