Method: userProfiles.guardianInvitations.create

Cria um convite para o responsável e envia um e-mail para o responsável solicitando a confirmação de identidade do responsável.

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

O objeto de solicitação precisa ter os campos studentId e invitedEmailAddress definidos. Deixar de definir esses campos ou configurar outros 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 os responsáveis, o responsável em questão já tiver recusado muitas solicitações para o aluno, os responsáveis não estiverem ativados para o domínio em questão ou outros erros de acesso.
• RESOURCE_EXHAUSTED se o estudante ou o responsável tiver excedido o limite de links de responsável.
• 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 da carteira de estudante fornecida não for reconhecido (não é um endereço de e-mail nem um userId desta API). Esse erro também será retornado se os campos somente leitura estiverem definidos ou se o campo state estiver definido como um valor diferente de PENDING.
• NOT_FOUND se o ID de estudante fornecido for válido, mas o Google Sala de Aula não tiver um registro desse estudante.
• ALREADY_EXISTS se já houver um convite pendente para o responsável pelo estudante e pelo invitedEmailAddress fornecido ou se o invitedEmailAddress informado corresponder à Conta do Google de um Guardian para o usuário.