Method: userProfiles.guardianInvitations.patch

修改监护人邀请。

目前，唯一有效的修改是将 state 从 PENDING 更改为 COMPLETE。此操作会撤销邀请。

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

  • 如果当前用户没有权限管理监护人、没有为相关网域启用监护人，或有其他访问错误，则监护人将无法使用，PERMISSION_DENIED。
  • 如果监护人链接未处于 PENDING 状态，则为 FAILED_PRECONDITION。
  • 如果无法识别学生 ID 的格式（它不是电子邮件地址，也不是此 API 中的 userId）、传递的 GuardianInvitation 具有 state 以外的 COMPLETE，或者它修改了 state 以外的字段，则为 INVALID_ARGUMENT。
  • 如果提供的学生 ID 是有效的学生 ID，但 Google 课堂没有该学生的记录，或者 id 字段未提及 Google 课堂已知的监护人邀请，则为 NOT_FOUND。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
studentId

string

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

string

要修改的 GuardianInvitation 的 id 字段。

查询参数

参数
updateMask

string (FieldMask format)

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

  • state

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

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

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

如需了解详情，请参阅授权指南。