本页概述了如何构建扩展 Google Chat 的 Google Workspace 插件。
扩展 Chat 的 Google Workspace 插件可以帮助用户执行以下操作：
- 预览 Chat 消息中的链接，无需离开对话即可采取行动。
- 自动执行或执行跨 Google Workspace 应用的任务。
- 接收有关外部工具或服务的提醒或通知。
Google Workspace 插件在 Chat 中的运作方式
在 Chat 中，插件会作为 Google Chat 应用显示给用户。如需与用户互动，Chat 应用可以执行以下操作：
- 发送消息，其中包含文本、 卡片和互动式界面元素。
- 响应快速命令。
- 响应斜杠命令。
- 打开对话框， 帮助用户完成多步流程，例如填写表单数据。
- 预览链接通过附加包含实用信息的卡片来预览消息中的链接，让用户可以直接从对话中采取行动。
开始使用
如需开始构建可在 Chat 中运行的 Google Workspace 插件，请参阅以下文档：
- 试用快速入门，使用 Google Apps 脚本或 HTTP 服务构建基本的 Chat 应用。
- 使用 Chat API 配置 Chat 应用 及其互动功能。
- 了解如何使用插件触发器、操作和事件对象构建 Chat 界面。
限制和已知问题
以下 Chat 和插件功能不可用：
- AppSheet AppSheet Chat 应用架构不可用。 请改用 HTTP 服务、 Apps 脚本、 Dialogflow ES或 Dialogflow CX或 Pub/Sub构建 Chat 应用。
- 自定义授权卡片。如需从 Chat 对您的 服务进行身份验证并授予授权，Chat 应用必须 返回基本授权卡片。
- Chat 边栏中的 插件首页。如果您为插件配置了 首页触发器，则首页仅显示在插件扩展的其他 Google Workspace 应用的边栏中。
- Chat 应用首页， 显示在与 Chat 应用 的私信的 **首页** 标签页中。
如果您要更新现有的 Google Workspace 插件，请考虑以下 Chat 应用配置要求 ：
- Google Workspace Marketplace 安装设置 必须允许个人用户和 Google Workspace 管理员 安装该插件。
- 系统会忽略插件清单
manifest
(
addons.common) 中的任何常见配置设置。如需将插件配置为在 Chat 中运行，您必须启用并配置 Chat API。如需了解相关步骤，请参阅 配置 Google Chat 应用。 - 如需在 Chat 中部署和测试插件，您必须使用 Chat API 的公开范围 设置。系统会忽略您在 Google Workspace Marketplace SDK 中配置的任何公开范围或测试设置。如需在 Chat 中部署插件的测试版，请参阅 Chat API 文档中的 测试 Google Chat 应用的互动功能 。
- 如果您的插件已发布到 Google Workspace Marketplace，则无法保存对 Google Chat API 配置设置所做的任何更改的草稿。 更新 Chat API 配置设置后，所有现有用户都可以立即使用更新后的 Chat 应用。如需更新 Marketplace 商品详情， 您可以在 提交任何更改之前 创建草稿。
相关主题
- Google Chat API 文档概览
- 试用示例：