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

修改监护人邀请。