发布 Google Chat 应用

创建 Chat 应用后,您可以发布该应用,以供所选人员或群组、Google Workspace 组织中的所有人或任何 Google Chat 用户使用。

用户如何发现和使用 Chat 应用

如要探索 Google Chat 应用,用户可以执行以下任一操作:

  • 在 Google Chat 或 Google Workspace Marketplace 中搜索并安装 Chat 应用。
  • 与添加到 Chat 聊天室中的应用互动。
  • 在 Google Workspace 管理员代表用户安装应用后,在其私信面板中发现该应用。

如需开始使用某个应用,Google Chat 用户可以向该应用发起私信或将其添加到聊天室。用户也可以通过用 @ 提及的方式添加该应用。以下示例展示了用户 @ 如何提及 Chat 应用以将其添加到聊天室:

在消息中输入 @,即可将应用添加到聊天室。

Google Workspace 管理员如何安装 Chat 应用

Google Workspace 管理员可以在 Google Workspace Marketplace 中找到 Chat 应用,并为其组织中的用户安装应用。管理员安装 Chat 应用时,该应用会显示在用户的私信面板中。

Google Workspace 管理员还可以在其 Google Workspace 组织中管理 Chat 应用的使用并将其列入许可名单。如果您正在为使用许可名单的组织开发 Chat 应用,则必须请求管理员将您的 Chat 应用添加到许可名单中,以便用户可以找到和使用该应用。如需了解详情,请参阅 Google Workspace 管理员帮助文档:允许用户安装 Chat 应用

使用 Google Cloud 控制台配置和发布 Chat 应用

如需发布您的 Chat 应用并使其可供其他人使用,您通常需要执行以下步骤:

  1. 启用并配置 Google Chat API。配置 API 时,您可以向其他 Google Chat 用户授予对您的 Chat 应用的访问权限,以便进行测试。
  2. 使用 Google Workspace Marketplace SDK 发布应用。您可以将 Chat 应用配置为可供 Google Workspace 组织中的用户或所有 Google Chat 用户使用。
  3. 如果您的 Google Workspace 组织管理对 Chat 应用的访问权限,请请求 Google Workspace 管理员将该应用添加到组织的许可名单中。

Chat 应用的公开范围和发布设置

下表介绍了如何根据您的 Chat 应用的目标设备配置 Google Chat API 和 Google Workspace Marketplace SDK 的设置:

目标应用用户 身份验证方法 Google Chat API 设置 Google Workspace Marketplace SDK 设置 我的 Chat 应用会发布在哪里?
您的小型团队 用户应用身份进行身份验证。 公开范围设置中,指定可以访问应用的用户或 Google 群组。

如果您的 Google Workspace 帐号要求将应用列入许可名单,则您最多只能指定 5 个个人电子邮件地址(您无法指定 Google 群组)。

您无需为 Chat 应用配置 Google Workspace Marketplace SDK。 团队成员可以在 Google Chat 中找到和使用您的 Chat 应用。
你的大型团队 用户应用身份进行身份验证。 公开范围设置中,指定由哪些用户或 Google 群组测试您的 Chat 应用。

测试完成后,使用 Google Workspace Marketplace SDK 中的设置将 Chat 应用发布到您的 Google Workspace 组织。

应用显示设置设置为不公开

安装设置设为个人 + 管理员

如果您的 Google Workspace 账号要求将应用列入许可名单,请请求管理员将您的 Chat 应用添加到许可名单中,以便用户可以找到并使用该应用。如需了解详情,请参阅 Google Workspace 管理员帮助文档:允许用户安装 Chat 应用

您的 Google Workspace 组织中的任何人都可以在 Google Chat 中找到并安装您的 Chat 应用,并在 Google Workspace Marketplace 中查看您的应用。用户和 Google Workspace 管理员可以从 Marketplace 安装您的应用。

您的 Google Workspace 组织 用户应用身份进行身份验证。 公开范围设置中,指定由他人或 Google 群组测试您的 Chat 应用。

测试完成后,使用 Google Workspace Marketplace SDK 中的设置将 Chat 应用发布到您的 Google Workspace 组织。

应用显示设置设置为不公开

安装设置设为个人 + 管理员

您的 Google Workspace 组织中的任何人都可以在 Google Chat 中找到并安装您的 Chat 应用,并在 Google Workspace Marketplace 中查看您的应用。只有 Google Workspace 管理员可以从 Marketplace 安装您的应用。

所有人(公共 Chat 应用) 用户应用身份进行身份验证。 公开范围设置中,指定由他人或 Google 群组测试您的 Chat 应用。

测试完成后,请使用 Google Workspace Marketplace 中的设置公开发布您的 Chat 应用。

应用显示设置设为公开

安装设置设为个人 + 管理员

任何 Google Workspace 用户都可以在 Google Chat 中找到并安装您的 Chat 应用,并在 Google Workspace Marketplace 中查看您的应用。只有 Google Workspace 管理员可以从 Marketplace 安装您的应用。

启用并配置 Google Chat API

Google Cloud 控制台中为您的应用设置项目并启用 Google Chat API:

  1. 使用下面的按钮创建新项目(或选择现有项目)并向其添加服务帐号。为服务帐号授予 Project Owner 角色。
    启用 API
  2. 保存下载的 JSON 密钥。应用可以使用此密钥对异步发送到聊天室的消息进行身份验证。
  3. 中打开您的项目。在 API 列表中,点击 Google Chat API
  4. 选择配置标签页,然后输入应用的信息,如下表所述。

保存应用配置后,该应用即可供 Google Workspace 组织中的指定用户使用。

Google Chat API 配置设置

字段 说明
应用名称 用户在与您的 Chat 应用互动时使用的名称。
头像网址 指向至少 128x128 的方形图形图片(例如 PNG 或 JPEG)的 HTTPS 网址,该图片会显示为您的 Chat 应用头像。
说明 显示在 Chat 应用名称下方的 Chat 应用功能说明。
功能 决定 Chat 应用如何与用户互动的一组字段:
  • 接收 1 对 1 消息:用户可以直接在 Google Chat 中查找 Chat 应用并向其发送消息。
  • 加入聊天室和群组对话:用户可以将 Chat 应用添加到聊天室和群组对话中。
连接设置 Chat 应用的端点,可以是以下端点之一:
  • 应用网址:托管 Chat 应用实现的 HTTPS 端点。
  • Apps 脚本项目:实现 Chat 应用的 Apps 脚本项目的部署 ID。
  • Cloud Pub/Sub 主题名称:Chat 应用作为端点订阅的 Cloud Pub/Sub 主题。
  • Dialogflow:使用 Dialogflow 集成注册 Chat 应用。如需了解详情,请参阅有关与 Google Chat 集成的 Dialogflow 文档
斜杠命令 在 Google Chat 中可以向用户显示的命令。通过此设置,用户可以在 Google Chat 中查看您的 Chat 应用的核心操作,并选择他们希望与之互动的特定操作。
链接预览 Chat 应用可识别的网址格式,并在用户发送链接时提供额外内容。如需了解详情,请参阅预览链接
显示设置 最多可以有 5 个个人或一个或多个 Google 群组查看和安装您的 Chat 应用。您可以使用此字段测试您的 Chat 应用,或与您的团队分享该 Chat 应用。如需了解详情,请参阅 Chat 应用的公开范围和发布设置

授予应用配置权限

您可以向特定用户授予访问应用配置页面的权限。为此,请使用 Chat 应用 OwnerChat 应用查看者 IAM 角色。具有这些角色的用户无法通过 API 和服务信息中心导航到应用配置页面,但可以通过导航到其项目的控制台来访问配置页面,如下所示:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

使用 Google Workspace Marketplace SDK 发布应用

使用 Google Workspace Marketplace SDK 执行以下任一操作:

  • 公开发布您的 Chat 应用,并让任何 Google Chat 用户将您的应用添加到聊天室。
  • 向使用 Google Workspace 的组织发布 Chat 应用。
  • 让 Google Workspace 管理员能够看到您的应用,以便他们为组织中的用户安装应用。您的应用必须提供私信功能,才能向 Google Workspace 管理员显示。

在使用 Google Workspace Marketplace SDK 发布应用之前,请按以下步骤操作:

  1. 通过 Chat 安装即可测试 Chat 应用。确保您的应用功能齐全且没有开发中的工作。
  2. 查看发布要求,并验证您的应用是否满足所有要求。请参阅审核领域
  3. 记录应用的版本号 - 您需要用它来配置 Google Workspace Marketplace SDK。

当您准备好发布应用后,请参阅概览:发布应用