Method: users.availability.patch

更新人类用户的可用性信息。只能通过此方法更新 customStatus 字段。

此方法仅更新经过身份验证的用户的可用性。

需要使用以下授权范围之一进行用户身份验证：

  • https://www.googleapis.com/auth/chat.users.availability

HTTP 请求

PATCH https://chat.googleapis.com/v1/{availability.name=users/*/availability}

网址采用 gRPC 转码语法。

路径参数

参数
availability.name

string

标识符。用户可用性的资源名称。

格式：users/{user}/availability

{user} 是 People API 或 Admin SDK Directory API 中 Person 的 ID。例如，users/123456789。

用户的电子邮件地址或 me 也可用作别名来引用调用方。例如，users/user@example.com 或 users/me。

查询参数

参数
updateMask

string (FieldMask format)

必需。要更新的字段列表。唯一可以更新的字段是 customStatus。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.users.availability

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