REST Resource: userProfiles.guardianInvitations

Recurso: GuardianInvitation

Um convite para se tornar o responsável de um usuário especificado, enviado para um endereço de e-mail especificado.

Representação JSON
{
  "studentId": string,
  "invitationId": string,
  "invitedEmailAddress": string,
  "state": enum (GuardianInvitationState),
  "creationTime": string
}
Campos
studentId

string

Documento de identificação do estudante (no formato padrão)

invitationId

string

O identificador exclusivo deste convite.

Somente leitura.

invitedEmailAddress

string

Endereço de e-mail para o qual o convite foi enviado. Esse campo só é visível para administradores do domínio.

state

enum (GuardianInvitationState)

O estado do convite.

creationTime

string (Timestamp format)

A hora em que este convite foi criado.

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

GuardianInvitationState

Estado do convite do responsável.

Enums
GUARDIAN_INVITATION_STATE_UNSPECIFIED Nunca devem ser devolvidos.
PENDING O convite está ativo e aguardando resposta.
COMPLETE O convite não está mais ativo. Ela pode ter sido aceita, recusada, cancelada ou expirou.

Métodos

create

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

get

Retorna o convite de um responsável específico.

list

Retorna uma lista de convites para responsáveis que o usuário solicitante tem permissão para ver, filtrada pelos parâmetros fornecidos.

patch

Modifica o convite do responsável.