扩展 Google Chat

本页面简要介绍了如何构建可扩展 Google Chat 的 Google Workspace 插件。

用于扩展 Chat 功能的 Google Workspace 插件可帮助用户执行以下任一操作:

  • 预览 Chat 消息中的链接,并在不离开对话的情况下执行操作。
  • 在 Google Workspace 应用中自动执行或执行任务。
  • 接收有关外部工具或服务的提醒或通知。

Google Workspace 插件在 Chat 中的运作方式

在 Chat 中,插件会以 Google Chat 应用的形式向用户显示。为了与用户互动,Chat 应用可以执行以下操作:

  • 发送消息,其中包含文本、卡片和交互式界面元素。
  • 响应斜杠命令
  • 打开对话框,帮助用户完成多步骤流程,例如填写表单数据。
  • 通过附加包含实用信息的卡片,在消息中预览链接,让用户能够直接在对话中执行操作。

开始使用

如需开始构建可在 Chat 中使用的 Google Workspace 插件,请参阅以下文档:

限制和已知问题

以下 Chat 和插件功能无法使用:

如果您要更新现有的 Google Workspace 插件,请考虑 Chat 应用的以下配置要求

  • Google Workspace Marketplace 安装设置必须允许个人和 Google Workspace 管理员安装该插件。
  • Chat 会忽略插件清单 (addons.common) 中的所有常规配置设置。若要配置该插件在 Chat 中正常运行,您必须启用并配置 Chat API。如需了解相关步骤,请参阅配置 Google Chat 应用
  • 如果您使用 HTTP 服务进行构建,则必须启用 Google Workspace Add-ons API。REST 资源 deploymentproject 仅适用于其他 Google Workspace 应用中的插件部署。
  • 如需在 Chat 中部署和测试插件,您必须使用 Chat API 的公开范围设置。系统会忽略您在 Google Workspace Marketplace SDK 中配置的所有公开范围或测试设置。如需在 Chat 中部署插件测试版,请参阅 Chat API 文档中的测试 Google Chat 应用的交互功能
  • 如果您的插件已发布到 Google Workspace Marketplace,您将无法保存对 Google Chat API 配置设置所做的任何更改的草稿。更新 Chat API 配置设置后,所有现有用户都会立即看到更新后的 Chat 应用。如需更新购物平台商品详情,您可以在提交任何更改之前创建草稿