概览

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

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

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

信息和聊天室

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

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

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

  • Google Chat 和 Chat 应用之间的消息遵循定义的消息格式，其中每条消息都由一个 JSON 对象组成，该对象的组件用于指定消息的用户 ID、样式、内容和其他方面。聊天应用可以发送以下类型的消息：

    • 短信包含纯文本内容，文本格式有限。

    • 卡片消息用于定义要在聊天室中显示的卡片的格式、内容和行为。例如，卡片消息可以包含一个带有链接的按钮，该链接会打开一个对话框以从用户收集信息。

      使用卡片制作工具设计和预览 Chat 应用的消息和界面：

      打开卡片制作工具

  • 在 Google Chat 中，聊天室可以具有以下上下文：

    • 命名聊天室或群组聊天室对多位用户可见。
    • 私信仅对相应聊天室中的用户可见。

使用场景

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

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

  • 工作流管理
  • 设置和配置
  • 生成有序
  • 搜索
  • 数据收集

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

  • 查询信息 - Chat 应用可以根据用户输入的结构化查询或自由文本查询检索信息。
  • 提交工单 - Chat 应用可以使用用户提供的信息生成突发事件报告或其他工件。
  • 协调工作 - 聊天应用可以改进团队成员之间的互动方式，例如提供“团队记忆”或安排资源。

构建 Chat 应用

本部分介绍了您可以构建的 Chat 应用的一些类型。

对于您构建的每个 Chat 应用，您都必须在 Google Cloud 控制台中创建一个单独的 Google Cloud 项目。如需部署聊天应用并与其他 Google Chat 用户共享，您需要在 Google Workspace Marketplace 上发布和列出这些应用。如需了解详情，请参阅为 Chat 应用创建和管理部署。

互动式 Chat 应用

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

  • 使用文本消息或卡片消息回复@提及、斜杠命令或私信。
  • 打开对话框，帮助用户完成多步骤流程，例如填写表单数据。
  • 通过附加包含实用信息的卡片来预览链接，让用户能够直接在对话中执行操作。

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

非交互式 Chat 应用

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

事件驱动型 Chat 应用

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

选择 Chat 应用架构

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

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

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

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

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

  • 默认情况下，聊天应用只能读取调用它们的用户或在调用应用的同一邮件中被 @提及的用户的基本身份信息。这些信息包括用户的显示名称、用户 ID、电子邮件地址和头像图片。

  • 对于预览链接的 Chat 应用，Chat 应用可以读取添加到消息中且与 Chat 应用配置的网址格式匹配的网址。

  • 如果 Chat 应用需要访问其他数据才能向用户提供增强功能（例如读取所有消息或聊天室中的成员列表），请设置身份验证，以便应用可以访问这些数据。如果要访问用户数据，Chat 应用会提示用户授予访问权限，并且用户必须授予访问权限。如需了解详情，请参阅将 Chat 应用与其他服务和工具相关联。

希望了解 Google Chat API 的实际应用情况？
Google Workspace Developers 频道提供有关提示、技巧和最新功能的视频。