Method: users.availability.get

返回 Google Chat 中人类用户的有空/忙碌信息。例如，此方法可用于检查用户是否在线或处于离开状态，也可用于检索用户的自定义状态消息。

此方法仅检索经过身份验证的用户的空闲情况。

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

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要检索的空闲情况的资源名称。

格式：users/{user}/availability

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

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

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

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