EventType

Google Chat 应用互动事件的类型。

如需配置 Chat 扩展应用以接收互动事件,请参阅接收和响应用户互动

注意:此 EventType 仅用于聊天互动事件。如果您的 Chat 应用是作为 Google Workspace 加载项构建的,请参阅加载项文档中的 Chat 事件对象

枚举
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 应用的私信。对于此类事件,仅包含 typeuserspace 字段。如需了解详情,请参阅为 Google Chat 应用构建首页

SUBMIT_FORM

用户在应用首页卡片中提交信息。对于此类事件,仅包含 typeuserspace 字段。如需了解详情,请参阅为 Google Chat 应用构建首页