REST Resource: userProfiles.guardianInvitations

Resource: GuardianInvitation

An invitation to become the guardian of a specified user, sent to a specified email address.

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

string

ID of the student (in standard format)

invitationId

string

Unique identifier for this invitation.

Read-only.

invitedEmailAddress

string

Email address that the invitation was sent to. This field is only visible to domain administrators.

state

enum (GuardianInvitationState)

The state that this invitation is in.

creationTime

string (Timestamp format)

The time that this invitation was created.

Read-only.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

GuardianInvitationState

State of a guardian invitation.

Enums
GUARDIAN_INVITATION_STATE_UNSPECIFIED Should never be returned.
PENDING The invitation is active and awaiting a response.
COMPLETE The invitation is no longer active. It may have been accepted, declined, withdrawn or it may have expired.

Methods

create

Creates a guardian invitation, and sends an email to the guardian asking them to confirm that they are the student's guardian.

get

Returns a specific guardian invitation.

list

Returns a list of guardian invitations that the requesting user is permitted to view, filtered by the parameters provided.

patch

Modifies a guardian invitation.