识别并指定 Google Chat 用户

本页介绍了 Google Chat 应用识别或指定的方式 聊天用户。

为执行以下任一操作，Chat 应用 必须指定用户：

• 创建一条消息 @ 提及用户。
• 邀请用户或将用户添加到 现有空间 或将用户添加到 新空间。
• 查找私信 Chat 应用与指定用户之间分配，或 两个用户之间。
• 获取用户在聊天室中的成员资格详细信息。
• 向用户发送私信。
• 使用订阅用户 使用 Google Workspace Events API 获取有关其成员资格变更的活动。

Chat 如何识别用户

Google Chat API 会生成 User 资源 所有 Chat 用户。下面介绍了 User 字段：

• name 是资源的资源名称，格式为 users/{user}， 其中 {user} 表示唯一且稳定的标识符。users/app可以 用作 发起调用的 Chat 应用的别名。
• type 是用户类型。此类型会告知 Chat 用户是 Chat 应用或个人。对于 聊天应用，值为 BOT。对于用户，此值为 HUMAN。

在调用 Google Chat API 中指定用户

如需指定用户，请为 {user} 值使用以下值：

• 对于 Google Workspace 组织中的用户，请使用以下任一 方法：

  • name User 资源 例如 users/123456789。
  • 名称的 {person_id} People API 中的 Person 资源 其中 resourceName 为 people/{person_id}。例如， Chat API 中的 users/123456789 代表同一个人 在 People API 中使用 people/123456789。
  • Directory API 中 User 资源的 id，例如 Chat API 中的 users/123456789 代表同一个人 在 Directory API 中以 users/123456789 的形式指定。

• 对于外部 Google Workspace 组织中的用户或用户 如果使用 Google 账号，请使用电子邮件别名，例如 users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com 或 users/EMAIL_USERNAME@gmail.com。

从互动事件中识别用户

每当用户与 Chat 应用互动时， Chat 会发送 互动事件，其中包含有关 和用户互动。例如，当 用户在消息中提及一款聊天应用， 聊天应用会接收互动相关信息 包括消息内容以及发送者聊天应用 在检索 Chat 资源的相关信息时引用用户。

为了识别与 Chat 应用互动的用户， 获取 name 属性的值， User 个资源， 您可以从 Event.user.name。

以下 JSON 示例显示了 与 Chat 应用的交互：

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

消息是一种特定类型的互动。为了识别 向 Chat 应用发送消息， 获取 name 属性的值， User 资源，使用 以下：

• spaces.messages.sender.name
• Event.user.name

相关主题

• 向聊天室添加用户。
• 管理聊天室中的成员。
• @ 在消息中提及用户。