本页介绍了 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 组织中的用户,请使用以下任一 方法:
对于外部 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": "[email protected]"
}
}
消息是一种特定类型的互动。为了识别
向 Chat 应用发送消息,
获取 name
属性的值,
User
资源,使用
以下: