概览

构建 Google Chat 应用，将您的服务和资源直接带入 Google Chat，让用户无需离开对话即可获取信息并采取行动。

Google Chat 通过提供以下功能支持团队协作：

用户之间的私信。
聊天室中的话题式对话。
Chat 聊天室可让您按项目、按团队或其他方式专门打造讨论空间。
可参与聊天室或回复私信的聊天应用。

消息和聊天室

Google Chat 和 Chat 应用之间的互动是在特定聊天室上下文中使用消息进行。例如，Chat 应用可以向特定的 Chat 聊天室发送文本（一种消息类型）。

消息包括 Chat 应用互动、文字或卡片，而聊天室包括聊天室和私信。

上图显示了消息和聊天室可用的不同类型的互动和上下文：

Google Chat 和 Chat 应用之间的消息遵循定义的消息格式，其中每条消息都包含一个 JSON 对象，该对象的组件指定了消息的用户 ID、样式、内容和其他方面。聊天应用可以发送以下类型的消息：
- 短信包含文本格式有限的纯文本内容。
- 卡片消息定义了要在空间中显示的卡片的格式、内容和行为。例如，卡片消息可以包含一个带有链接的按钮，点击此链接可打开一个对话框，以便收集用户信息。
在 Google Chat 中，聊天室可以具有以下上下文：
- 多位用户可以查看已命名的聊天室或群组聊天室。
- 私信只会显示给该聊天室中的用户。

用例

将 Chat 应用添加到 Chat 等对话平台后，用户无需更改上下文即可提出问题和发出命令。在其后端，Chat 应用可以访问其他系统，充当这些系统的中间层。

这种能够在保持统一认知体验的同时，提供对各种资源和工具的访问权限，可以为许多类型的应用提供框架，包括：

工作流管理
设置和配置
生成订单
搜索
数据收集

您可以要求 Chat 应用在 Chat 聊天室中执行的操作包括以下示例：

查询信息 - Chat 应用可以基于用户输入的结构化或自由文本查询来检索信息。
文件工单 - Chat 应用可以使用用户提供的信息生成突发事件报告或其他工件。
协调工作 - Chat 应用可以改进团队成员之间的互动方式，例如提供“团队内存”或调度资源。

构建交互式聊天应用

许多 Chat 应用允许用户直接与 Chat 应用发送消息和互动。交互式聊天应用可以执行以下任一操作：

使用短信或卡片消息回复 @提及、斜杠命令或私信。
打开对话框，帮助用户完成多步流程，例如表单数据。
预览链接，方法是附加包含实用信息的卡片，让用户直接从对话中执行操作。

为了与用户互动，您的 Chat 应用必须能够接收和响应互动事件。如需构建交互式 Chat 应用，请参阅接收和响应 Google Chat 应用互动事件。

构建非交互式 Chat 应用

对于用户来说，Google Chat 应用也可以是非交互式应用，如果用户无法直接与 Chat 应用互动，但 Chat 应用会直接调用 Google Chat API。例如，您可以创建一个 Chat 应用，该应用在聊天室中发送消息，但用户无法响应 Chat 应用。这种类型的 Chat 应用架构对于闹钟报告等用途非常有用。如需了解详情，请参阅 Google Chat API 概览。

构建事件驱动型 Chat 应用

聊天应用可以使用 Google Workspace Events API 订阅有关 Chat 资源的事件。通过订阅，您的 Chat 应用可以接收有关事件的信息，这些事件表示对订阅的 Google Workspace 资源的更改。例如，Chat 应用可以响应对 Chat 应用所订阅的聊天室的更改，例如向添加到聊天室的新成员发送欢迎辞。如需了解详情，请参阅订阅 Google Chat 事件。

选择 Chat 应用架构

Chat API 提供了多种将应用集成到 Chat 聊天室的方法，但不提供或规定任何特定方式来实现 Chat 应用逻辑。您可以创建命令驱动型 Chat 应用，或使用任何类型的语言处理和 AI 服务或模块，并在各种平台上执行此操作，包括：

AppSheet
Google Apps 脚本
Pub/Sub
Google Cloud 或本地 HTTP 服务器

如需了解详情，请参阅选择聊天应用架构。

应用对用户数据的访问权限

调用 Chat 应用时，该应用需要知道是谁在调用该应用、在什么情境下调用以及如何处理调用方。如需访问这些基本身份数据以外的数据，必须通过身份验证向 Chat 应用授予访问权限。

默认情况下，聊天应用只能读取调用该应用的用户或用“@”提及的用户的基本身份信息。这些信息包括用户的显示名称、用户 ID、电子邮件地址和头像图片。
对于预览链接的 Chat 应用，Chat 应用可以读取添加到消息中且与 Chat 应用配置的网址格式匹配的网址。
如果 Chat 应用需要访问其他数据以向用户提供增强功能（例如读取聊天室中的所有消息或成员列表），请设置身份验证，以便访问这些数据。如果访问用户数据，Chat 应用会提示用户请求访问权限，并且必须由用户授予该访问权限。如需了解详情，请参阅将 Chat 应用与其他服务和工具相关联。