REST Resource: userProfiles.guardianInvitations

Zasób: Zaproszenie dla opiekuna

Zaproszenie do zostania opiekunem określonego użytkownika wysłane na podany adres e-mail.

Zapis JSON
{
  "studentId": string,
  "invitationId": string,
  "invitedEmailAddress": string,
  "state": enum (GuardianInvitationState),
  "creationTime": string
}
Pola
studentId

string

legitymacja ucznia (w formacie standardowym)

invitationId

string

Unikalny identyfikator tego zaproszenia.

Tylko do odczytu.

invitedEmailAddress

string

Adres e-mail, na który zostało wysłane zaproszenie. To pole jest widoczne tylko dla administratorów domeny.

state

enum (GuardianInvitationState)

Stan, w którym znajduje się to zaproszenie.

creationTime

string (Timestamp format)

Godzina utworzenia tego zaproszenia.

Tylko do odczytu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

GuardianInvitationState

Stan zaproszenia opiekuna.

Wartości w polu enum
GUARDIAN_INVITATION_STATE_UNSPECIFIED Nie należy go nigdy zwracać.
PENDING Zaproszenie jest aktywne i czeka na odpowiedź.
COMPLETE Zaproszenie nie jest już aktywne. Mogła zostać zaakceptowana, odrzucona, wycofana lub wygasła.

Metody

create

Tworzy zaproszenie dla opiekuna i wysyła do niego e-maila z prośbą o potwierdzenie, że jest opiekunem ucznia.

get

Zwraca określone zaproszenie opiekuna.

list

Zwraca listę zaproszeń opiekunów, które może wyświetlić użytkownik wysyłający prośbę, przefiltrowaną według podanych parametrów.

patch

Modyfikuje zaproszenie opiekuna.