EventType
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
枚举 |
UNSPECIFIED |
枚举的默认值。请勿使用。 |
MESSAGE |
用户向 Chat 应用发送消息,或在聊天室中调用 Chat 应用。消息事件的示例包括:
- 与 Chat 应用之间的私信 (DM) 聊天室中的任何消息。
- 多人聊天室中的消息,其中有人 @提及了 Chat 应用,或使用了该应用的某个斜杠命令。
- 如果您已为 Chat 应用配置链接预览,则用户会发布一条包含与配置的网址格式匹配的链接的消息。
|
ADDED_TO_SPACE |
用户将 Chat 应用添加到聊天室,或者 Google Workspace 管理员为组织中的用户在私信聊天室中安装 Chat 应用。聊天应用通常会通过在聊天室中发布欢迎消息来响应此互动事件。 当管理员安装 Chat 扩展应用时,space.adminInstalled 字段会设置为 true ,用户无法卸载这些应用。如需了解管理员安装的 Chat 应用,请参阅 Google Workspace 管理员帮助文档在您的网域中安装 Marketplace 中的应用。 |
REMOVED_FROM_SPACE |
用户从聊天室中移除 Chat 应用,或者 Google Workspace 管理员为其组织中的用户卸载 Chat 应用。聊天应用无法通过消息响应此事件,因为它们已被移除。 当管理员卸载 Chat 应用时,space.adminInstalled 字段会设置为 false 。如果用户在管理员之前安装了 Chat 应用,则该用户仍会安装 Chat 应用,并且 Chat 应用不会收到 REMOVED_FROM_SPACE 互动事件。 |
CARD_CLICKED |
用户点击 Chat 应用中的卡片或对话框的互动元素,例如按钮。如需接收互动事件,按钮必须触发与 Chat 应用的另一次互动。例如,如果用户点击某个按钮来打开指向网站的链接,Chat 应用不会收到 CARD_CLICKED 互动事件;但在以下示例中,Chat 应用会收到互动事件:
- 用户点击卡片上的
Send feedback 按钮,系统会打开一个对话框,供用户输入信息。
- 用户在卡片或对话框中输入信息后,点击
Submit 按钮。
如果用户点击某个按钮来打开、提交或取消对话框,则 CARD_CLICKED 互动事件的 isDialogEvent 字段会设置为 true ,并包含 DialogEventType 。 |
WIDGET_UPDATED |
用户在卡片消息或对话框中更新 widget。当用户与具有关联操作的 widget 互动时,系统会触发此事件。 |
APP_COMMAND |
用户使用 Chat 应用命令,包括斜杠命令和快速命令。 |
APP_HOME |
用户打开了使用应用首页的 Chat 应用的私信。对于此类事件,仅包含 type 、user 和 space 字段。如需了解详情,请参阅为 Google Chat 应用构建首页。 |
SUBMIT_FORM |
用户在应用首页卡片中提交信息。对于此类事件,仅包含 type 、user 和 space 字段。如需了解详情,请参阅为 Google Chat 应用构建首页。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-12。
[null,null,["最后更新时间 (UTC):2025-09-12。"],[],["Google Chat apps can receive various interaction events. These include `MESSAGE` (user messages or @mentions), `ADDED_TO_SPACE` (app added to space), `REMOVED_FROM_SPACE` (app removed), `CARD_CLICKED` (user clicks a card element), `WIDGET_UPDATED` (widget update), `APP_COMMAND` (user command), `APP_HOME` (user opens app home), and `SUBMIT_FORM` (user submits app home card). Each event triggers specific app actions, like posting welcome messages or responding to user input.\n"],null,[]]