REST Resource: userProfiles.guardianInvitations

Ресурс: GuardianInvitation

Приглашение стать опекуном указанного пользователя, отправленное на указанный адрес электронной почты.

JSON-представление
{
  "studentId": string,
  "invitationId": string,
  "invitedEmailAddress": string,
  "state": enum (GuardianInvitationState),
  "creationTime": string
}
Поля
studentId

string

ID студента (в стандартном формате)

invitationId

string

Уникальный идентификатор этого приглашения.

Только для чтения.

invitedEmailAddress

string

Адрес электронной почты, на который было отправлено приглашение. Это поле видно только администраторам домена.

state

enum ( GuardianInvitationState )

Состояние, в котором находится это приглашение.

creationTime

string ( Timestamp format)

Время создания этого приглашения.

Только для чтения.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

GuardianInvitationState

Состояние приглашения опекуна.

Перечисления
GUARDIAN_INVITATION_STATE_UNSPECIFIED Никогда не следует возвращать.
PENDING Приглашение активно и ожидает ответа.
COMPLETE Приглашение больше не активно. Оно могло быть принято, отклонено, отозвано или срок его действия истек.

Методы

create

Создает приглашение опекуна и отправляет опекуну электронное письмо с просьбой подтвердить, что он является опекуном учащегося.

get

Возвращает приглашение конкретного опекуна.

list

Возвращает список приглашений опекунов, которые запрашивающему пользователю разрешено просматривать, отфильтрованный по предоставленным параметрам.

patch

Изменяет приглашение опекуна.