Method: userProfiles.guardianInvitations.patch

修改监护人邀请。

目前，唯一有效的修改是将 state 从 PENDING 更改为 COMPLETE。这相当于撤回邀请。

此方法会返回以下错误代码：

PERMISSION_DENIED如果当前用户没有管理监护人的权限，或者没有为相关网域或其他监护人访问错误启用监护人，则会发生此情况。
如果监护人链接未处于 PENDING 状态，请使用 FAILED_PRECONDITION。
INVALID_ARGUMENT如果提供的学生 ID 的格式无法识别（不是电子邮件地址，或者来自此 API 的 userId）、传递的 GuardianInvitation state 的 state 并非 COMPLETE 或者 <br class="2-3"> 修改了其他字段。
如果提供的学生 ID 是有效的学生 ID，但 Google 课堂没有该学生的记录，或者 id 字段未引用 Google 课堂已知的监护人邀请，请使用 NOT_FOUND。

PATCH https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

网址采用 gRPC 转码语法。

参数

参数
`studentId`	`string` 要修改的监护人邀请的学生 ID。
`invitationId`	`string` 要修改的 `GuardianInvitation` 的 `id` 字段。

studentId

string

要修改的监护人邀请的学生 ID。

invitationId

string

要修改的 GuardianInvitation 的 id 字段。

参数

参数
`updateMask`	`string (FieldMask format)` 用于标识要更新的课程字段的掩码。必须填写此字段才能进行更新。如果指定了无效字段，更新将会失败。以下字段均有效： `state` 在查询参数中设置时，此字段应指定为 `updateMask=<field1>,<field2>,...` 这是由字段的完全限定名称组成的逗号分隔列表。示例：`"user.displayName,photo"`。

updateMask

string (FieldMask format)

用于标识要更新的课程字段的掩码。必须填写此字段才能进行更新。如果指定了无效字段，更新将会失败。以下字段均有效：

在查询参数中设置时，此字段应指定为

updateMask=<field1>,<field2>,...

这是由字段的完全限定名称组成的逗号分隔列表。示例："user.displayName,photo"。

请求正文包含一个 GuardianInvitation 实例。

如果成功，响应正文将包含一个 GuardianInvitation 实例。

需要以下 OAuth 作用域：

有关详情，请参阅 OAuth 2.0 概览。