创建 Chat 应用后，您可以发布该应用，以供选定的个人或群组、Google Workspace 组织中的所有人或任何 Google Chat 用户使用。
用户如何发现和使用 Google Chat 应用
如要发现 Google Chat 应用，用户可以执行以下任一操作：
- 搜索和安装 Google Chat 中的应用。
- 与添加到 Chat 聊天室中的应用互动。
- Google Workspace 管理员代表他们安装应用后，在其私信面板中发现该应用。
如需开始使用应用，Google Chat 用户可以向该应用发起私信或将该应用添加到聊天室。用户还可以通过用 @ 提及的方式添加该应用。以下示例展示了用户 @ 如何提及 Chat 应用以将其添加到聊天室：
或者，Google Workspace 管理员可以在 Google Workspace Marketplace 中找到 Chat 应用，并为其组织中的用户安装应用。 管理员安装 Chat 应用时，该应用会显示在用户的私信面板中。
Google Workspace 管理员还可以在其 Google Workspace 组织中管理 Chat 应用的使用，以及将 Chat 应用列入许可名单。如果您正在为使用许可名单的组织开发 Chat 应用，则必须请求管理员将您的 Chat 应用添加到许可名单中，以便用户可以找到和使用该应用。如需了解详情，请参阅 Google Workspace 管理员帮助文档允许用户安装 Chat 应用。
使用 Google Cloud 控制台配置和发布 Chat 应用
如需发布您的 Chat 应用并使其可供他人使用，您通常需要按以下步骤操作：
- 启用并配置 Google Chat API。配置 API 时，您可以向其他 Google Chat 用户授予您的 Chat 应用的访问权限以进行测试。
- 使用 Google Workspace Marketplace SDK 发布应用。您可以将 Chat 应用配置为可供 Google Workspace 组织中的用户或所有 Google Chat 用户使用。
- 如果您的 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 应用。 |
| 大型团队 | 以用户或应用身份进行身份验证。 | 在公开范围设置中，指定要测试您的 Chat 应用的用户或 Google 群组。
测试完成后，使用 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：
- 使用下面的按钮创建新项目（或选择现有项目）并向其中添加服务帐号。为服务帐号授予 Project Owner 角色。
启用 API - 保存下载的 JSON 密钥。应用可以使用此密钥对异步发送到聊天室的消息进行身份验证。
- 在 中打开您的项目。在 API 列表中，点击 Google Chat API。
- 选择配置标签页，然后输入应用的信息，如下表所述。
保存应用配置后，您的应用将可供 Google Workspace 组织中的指定用户使用。
Google Chat API 配置设置
| 字段 | 说明 |
|---|---|
| 应用名称 | 用户与您的 Chat 应用互动时使用的名称。 |
| 头像网址 | 指向至少 128x128 像素的方形图形图片（例如 PNG 或 JPEG）的 HTTPS 网址，该图片将显示为您的 Chat 应用的头像。 |
| 说明 | 显示在 Chat 应用名称下方的 Chat 应用功能说明。 |
| 功能 | 决定 Chat 应用如何与用户互动的一组字段：
|
| 连接设置 | Chat 应用的端点，可以是以下端点之一：
|
| 斜杠命令 | 可以在 Google Chat 中向用户显示的命令。通过此设置，用户可以在 Google Chat 中查看您的 Chat 应用的核心操作，并选择希望与之互动的特定操作。 |
| 链接预览 | Chat 应用可识别的网址格式，并在用户发送链接时为其提供其他内容。如需了解详情，请参阅预览链接。 |
| 公开范围 | 最多可以有 5 个个人或一个或多个 Google 群组查看和安装您的 Chat 应用。使用此字段可测试您的 Chat 应用，或与团队成员共享 Chat 应用。如需了解详情，请参阅Chat 应用的公开范围和发布设置。 |
授予应用配置权限
您可以向特定用户授予访问应用配置页面的权限。为此，请使用 Chat apps Owner 和 Chat apps Viewer 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 可以：
- 公开发布您的应用，并允许任何 Google Chat 用户将您的 Chat 应用添加到聊天室。
- 将您的应用发布到您的网域。
- 让 Google Workspace 管理员能够看到您的应用，以便他们可以为其组织中的用户安装应用。您的应用必须提供私信功能，才能向 Google Workspace 管理员显示。
在使用 Google Workspace Marketplace SDK 发布应用之前，请按以下步骤操作：
- 通过 Chat 安装 Chat 应用，即可测试该应用。确保您的应用功能完备，并且没有在开发中。
- 查看发布内容要求，并验证您的应用是否满足所有要求。请参阅审核领域。
- 记录应用的版本号 - 您需要此信息来配置 Google Workspace Marketplace SDK。
当您准备好发布应用后，请参阅概览：发布应用。
停用 Chat 应用
在您保存配置页后，系统会显示“应用状态”字段。通过此字段，您可以控制应用是处于已发布状态还是已停用状态。
如要停用 Chat 应用，请按以下步骤操作：
- 打开 Google Cloud Console。
- 如有必要，请选择托管 Chat 应用的 Google Cloud 项目：
- 点击“Google Cloud”旁边的向下箭头 。此时会显示一个列出当前项目的对话框。
- 选择托管迁移后的 Chat 应用的项目。
- 点击 Open。
- 搜索“Google Chat API”，然后点击 Google Chat API。
- 点击管理。
- 点击配置。
- 在“应用状态”部分，选择已停用。
- 点击保存。