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

修改监护人邀请。