REST Resource: userProfiles.guardianInvitations

資源:GuardianGuardian

擔任指定使用者的監護人的邀請,會傳送至指定的電子郵件地址。

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 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

GuardianInvitationState

監護人邀請的狀態。

列舉
GUARDIAN_INVITATION_STATE_UNSPECIFIED 不應傳回。
PENDING 邀請有效,正在等待回應。
COMPLETE 這項邀請已失效。該標籤可能尚未接受、拒絕、遭撤銷,或是可能已過期。

方法

create

建立監護人邀請並傳送電子郵件給監護人,請對方確認他們是學生的監護人。

get

傳回特定監護人邀請。

list

傳回提出要求的使用者可查看的監護人邀請清單,並依提供的參數篩選。

patch

修改監護人邀請。