REST Resource: userProfiles.guardianInvitations

Recurso: GuardianInvitation

Una invitación para convertirse en el tutor de un usuario específico que se envía a una dirección de correo electrónico determinada.

Representación JSON
{
  "studentId": string,
  "invitationId": string,
  "invitedEmailAddress": string,
  "state": enum (GuardianInvitationState),
  "creationTime": string
}
Campos
studentId

string

ID del estudiante (en formato estándar)

invitationId

string

Es el identificador único de esta invitación.

Solo lectura.

invitedEmailAddress

string

Dirección de correo electrónico a la que se envió la invitación. Solo los administradores del dominio pueden ver este campo.

state

enum (GuardianInvitationState)

Es el estado en el que se encuentra esta invitación.

creationTime

string (Timestamp format)

Es la hora en que se creó esta invitación.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

GuardianInvitationState

Es el estado de una invitación para el tutor.

Enumeraciones
GUARDIAN_INVITATION_STATE_UNSPECIFIED Nunca debería mostrarse.
PENDING La invitación está activa y está pendiente de respuesta.
COMPLETE La invitación ya no está activa. Es posible que se haya aceptado, rechazado, retirado o vencido.

Métodos

create

Crea una invitación para el tutor y le envía un correo electrónico para que confirme que es el tutor del estudiante.

get

Devuelve una invitación específica para el tutor.

list

Muestra una lista de invitaciones de guardián que el usuario solicitante puede ver, filtradas según los parámetros proporcionados.

patch

Modifica una invitación para el tutor.