概览

构建 Google Chat 应用，直接使用您的服务和资源 Google Chat，让用户无需离开 对话。

Google Chat 提供以下功能，为团队协作提供支持：

• 用户之间的私信。
• 聊天室中的消息串式对话。
• Chat 聊天室可让您在 。
• 可参与聊天室或回复直接消息的 Chat 扩展应用 消息。

消息和聊天室

Google Chat 和 Chat 应用之间会发生互动 在特定空间的上下文中使用 messages。例如， 聊天应用可以向 特定 Chat 聊天室。

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

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

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

  • 卡片消息 定义在 Google 地图中显示卡片的格式、内容和行为 空间。例如，卡片消息可以包含一个 链接，可打开一个对话框以向用户收集信息。

    ---

    使用卡片构建器设计和预览聊天应用的 JSON 卡片消息：

    打开卡片制作工具

    ---

• 在 Google Chat 中，聊天室可以执行以下操作： 以下上下文：

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

使用场景

将聊天应用添加到对话平台，例如 Chat 可让用户提出问题和发出命令， 变化的背景。Chat 应用可以在其后端执行以下操作： 并充当这些系统的中间方

让用户能够访问各种资源和工具，同时 维持统一的认知体验，可以为许多组织提供一个框架， 应用类型，其中包括：

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

您可能希望 Chat 应用执行的操作示例 包括：

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

构建 Chat 扩展应用

本部分介绍了一些可接受聊天的

对于您构建的每个 Chat 应用，您必须创建一个 单独的 Google Cloud 项目。要部署和共享 与其他 Google Chat 用户聊天，由您发布 并在 Google Workspace Marketplace 上架。有关详情，请参阅创建 以及管理 Chat 应用。

互动式聊天应用

许多聊天应用允许用户 Chat 应用。互动式聊天应用 可以执行以下任一操作：

• 回复 @提及、 斜杠命令 或包含短信或卡片消息的私信。
• 打开一个 dialog 更改为 可帮助用户完成多步流程，例如填写表单数据。
• 预览链接 通过附加包含实用信息的卡片，吸引用户采取行动 对话内容。

如要与用户互动，您的 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 脚本
• Dialogflow
• Pub/Sub
• Google Cloud 或本地 HTTP 服务器

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

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

调用 Chat 应用时，它需要知道是谁 调用它、在什么上下文中以及如何称呼调用方。访问数据 基本身份数据以外，Chat 应用必须 授予了访问权限 authentication。

• 默认情况下，Chat 应用只能读取 调用它们的用户 被用“@”提及的用户 。这些信息包括 用户的显示名称、用户 ID、电子邮件地址和头像图片。

• 对于符合以下条件的 Chat 扩展应用： 预览链接， Chat 应用可以读取添加到消息中的网址 与 Chat 应用配置的网址格式匹配。

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

相关主题

• 如需构建您的首个 Chat 应用，请按以下步骤操作： 浏览 Google Chat 应用示例，其中包括 快速入门、教程和 Codelab。
• 如果您已准备好使用 AI 构建 Chat 应用，不妨试试 教程 应对突发事件。
• 了解如何设计对用户有帮助并让他们满意的 Chat 扩展应用 请参阅识别您用户的需求
• 如果您不确定构建 聊天应用，请参阅 选择 Chat 应用架构。
• 了解如何部署和共享 Chat 应用 请参阅发布 Google Chat 应用。

想要了解 Google Chat API 的实际应用？ Google Workspace Developers 频道提供相关视频，介绍了 技巧和最新功能 立即订阅