如果您合并 Google Workspace 组织，可能需要迁移 Chat 应用，以确保其继续正常运行。
在迁移 Chat 应用之前，请与您组织的管理员确认管理设置是否会影响该应用。更改管理设置可能会恢复 Chat 应用的全部功能，从而无需迁移。例如，您的 Google Workspace 管理员可能必须将 Chat 应用添加到许可名单，或者必须允许用户安装 Chat 应用。如需了解详情，请参阅 确定在合并 Google Workspace 组织后是否需要迁移 Google Chat 应用。
确定需要迁移 Chat 应用后，请完成以下三步流程：
- 为 Chat 应用设置环境，具体方法是在合并后的组织中创建 Google Cloud 云项目、启用 API，并根据需要配置 OAuth 2.0 权限请求页面。
- 从新的 Cloud 项目重新部署 Chat 应用。
- 将重新创建的 Chat 应用添加到 Chat 聊天室或对话，然后关闭原来的 Chat 应用。
在合并后的组织中创建云项目并启用 API
在合并后的 Google Workspace 组织中为 Chat 应用创建新的云项目并启用 API，可确保您允许访问 Chat 应用的用户和群组能够正常访问该应用。
创建 Cloud 项目
Google Cloud 控制台
- 在 Google Cloud 控制台中，依次点击“菜单”图标 > IAM 和管理 > 创建项目。
-
在项目名称 字段中，为项目输入一个描述性名称。
可选：如需修改项目 ID，请点击修改。项目创建后，项目 ID 便无法更改，因此请选择一个满足项目生命周期需求的 ID。
- 在位置 字段中，点击浏览 以显示您的 项目潜在位置。然后，点击选择 。
- 点击创建 。Google Cloud 控制台会转到“信息中心”页面，您的项目会在几分钟内创建完毕 。
gcloud CLI
在以下任一开发环境中，访问 Google Cloud
CLI (gcloud)：
-
Cloud Shell：如需使用已设置 gcloud CLI 的在线终端，请激活 Cloud Shell。
激活 Cloud Shell -
本地 Shell：如需使用本地开发环境，请安装并初始化 gcloud CLI。
如需创建云项目，请使用gcloud projects create命令：gcloud projects create PROJECT_ID
启用 API
所有 Chat 应用都必须启用 Google Chat API。根据 Chat 应用的构建方式，您可能需要启用其他 API。例如，如果您 使用 Google Cloud Functions 构建 Chat 应用， 请启用 Cloud Build API、Cloud Functions API、Pub/Sub API、Cloud Logging API、 Artifact Registry API 和 Cloud Run API。最佳做法是，为了确保迁移后的应用正常运行，请在新云项目中启用与旧云项目中启用的 API 相同的 API。
如需启用 API，请执行以下操作：
Google Cloud 控制台
- 在 Google Cloud 控制台中，依次点击“菜单”图标 > API 和服务 > 库 > Google Workspace。
- 点击您要启用的 API。
- 点击启用 。
- 如需启用更多 API，请重复上述步骤。
Google Cloud CLI
- 安装或打开 Google Cloud 命令行界面 (CLI)。
-
运行
services enable命令，指定要启用的 API 服务。gcloud services enable API_SERVICE_ID
配置 Chat API
在新的云项目中，您必须使用 Chat API 来指定 Chat 应用的名称、说明和图标。如需 配置这些详细信息，请参阅 配置 Chat API
配置 OAuth 权限请求页面
您可能需要为云项目配置 OAuth 权限请求页面。如果您之前使用 OAuth 2.0 进行授权，请使用相同的授权访问范围。
- 在 Google API 控制台中，依次点击“菜单”图标 > Google Auth 平台 > 品牌。
- 如果您已配置 Google Auth 平台，则可以在品牌、受众群体和数据访问中配置以下 OAuth 权限请求页面设置。 如果您看到一条消息，提示尚未配置 Google Auth 平台，请点击开始使用：
- 在应用信息 下的应用名称 中，输入应用名称 。
- 在用户支持邮箱中，选择一个支持邮箱地址，以便用户在对权限请求有疑问时与您联系。
- 点击下一步 。
- 在受众群体下，为您的应用选择用户类型。
- 点击下一步 。
- 在联系信息下，输入一个邮箱地址，以便您接收有关项目变更的通知。
- 点击下一步 。
- 在完成 部分，查看《Google API 服务用户数据政策》，如果您同意该政策，请选择我同意 Google API 服务：用户数据政策。
- 点击继续 。
- 点击创建 。
- 如果您为用户类型选择了外部 ，请添加测试用户：
- 点击受众群体 。
- 在测试用户 下，点击添加用户 。
- 输入您的邮箱地址和任何其他已获授权的测试用户，然后点击保存 。
如果您要创建的应用供 Google Workspace 组织外部使用，请依次点击数据访问 > 添加或移除范围。在选择范围时，我们建议遵循以下最佳实践：
- 选择为应用提供所需最低访问权限的范围。如需查看可用范围的列表，请参阅Google API 的 OAuth 2.0 范围。
- 查看三个部分中列出的范围：非敏感 范围、敏感范围和受限范围。对于 “您的敏感范围”或“您的受限范围”部分中列出的任何范围，请尝试找出 替代的非敏感范围，以避免不必要的额外审核。
- 某些范围需要 Google 进行额外审核。对于仅供 Google Workspace 组织内部使用的应用，权限请求页面上不会列出范围，并且使用受限或敏感范围不需要 Google 进行进一步审核。如需了解详情，请参阅 范围类别。
- 选择应用所需的范围后，点击保存。
如需详细了解如何配置 OAuth 权限请求，请参阅 Google Auth 平台使用入门。
将 Chat 应用重新部署到新的云项目
根据 Chat 应用是使用 Apps 脚本、AppSheet 还是其他连接类型（例如 Python 或 Java）构建的，重新部署 Chat 应用的方式略有不同。无论哪种情况，您都不需要重新创建所有代码，但确实需要进行一些更改。
迁移 Chat 应用逻辑
根据 Chat 应用的 架构， 您可能需要将其他服务迁移到新的云项目：
- 对于 HTTP 应用，您还需要迁移使用 Cloud Run functions、Cloud Run 或 App Engine 构建的其余应用逻辑。
- 对于使用自然语言的对话式 Chat 应用，您还需要迁移 Dialogflow 代理。
- 对于在防火墙后构建的 Chat 应用，您还需要迁移 Pub/Sub 主题。
在新云项目中配置互动功能
如需重新部署使用 Python 或 Java 等语言构建的 Chat 应用，请在新云项目中配置 Chat 应用。
如需配置互动功能，请参阅 接收和响应用户互动。
重新部署 Apps 脚本 Chat 应用
如需重新部署使用 Apps 脚本构建的 Chat 应用，请将 Apps 脚本项目关联的云项目编号更改为属于新云项目的项目编号。然后，复制 Apps 脚本部署 ID 并将其粘贴到 Google API 控制台中的 Chat 应用配置页面。
复制 Cloud 项目编号
- 在 Google API 控制台中，依次点击“菜单”图标 > IAM 和管理 > 设置。
- 在项目编号 字段中，复制该值。
在 Apps 脚本项目中设置 Google Cloud 项目编号
前往 Apps 脚本。
在 Chat 应用 Apps 脚本项目中， 点击 项目设置 。
在 Google Cloud Platform (GCP) 项目 下，点击 更改项目 。
在 GCP 项目编号 中，粘贴 Google Cloud 项目编号。
点击设置项目 。
复制 Apps 脚本项目的部署 ID
- 在 Apps 脚本的右上角，依次点击 部署 > 管理部署。
- 在部署 ID 下，点击复制。
- 点击完成 。
重新配置并重新部署 Chat 应用
在 Google API 控制台中，搜索“Google Chat API”，然后点击 Google Chat API，再点击管理。
点击配置 标签页，然后输入以下必填信息：
- 应用名称：用户与 Chat 应用互动时使用的名称。
- 头像网址：指向方形图形图片 （例如 PNG 或 JPEG，至少 128x128）的 HTTPS 网址，该图片会显示为 Chat 应用的 头像。
- 说明： Chat 应用的预期用途的说明，显示在 Chat 应用名称下方。
如需启用互动功能，请点击启用互动功能 开关，以便用户与 Chat 应用互动：
在“连接设置”下，选择 Apps 脚本项目 。
在部署 ID 字段中，粘贴您之前复制的部署 ID。
如需完成其余配置，请参阅 在新云项目中配置 Chat 应用中的表格
点击保存 。
重新部署 AppSheet Chat 应用
如需重新部署使用 AppSheet 在新云项目中构建的 Chat 应用， 请将该应用复制到新的云项目。
更新服务账号
如果 Chat 应用以应用身份进行身份验证，并使用服务账号调用 Google API，请更新 Chat 应用的服务账号详细信息。如需了解详情，请参阅 以 Chat 应用身份进行身份验证。
分享 Chat 应用
在 Chat 应用可供新组织中的用户使用之前，您的管理员可能必须手动允许访问该 Chat 应用。如需了解详情，请参阅 Google Workspace Marketplace 文档中的为 Google Workspace 组织配置访问权限。
切换到新的 Chat 应用
现在，Chat 应用已迁移到新组织，接下来需要公开该应用。将其添加到 Chat 聊天室或私信，然后从中移除旧的 Chat 应用，以便用户仅向迁移后的 Chat 应用发送消息。
将新的 Chat 应用添加到 Chat 聊天室
前往 Chat。
点击私信或聊天室。
点击聊天室或人员名称旁边的下拉菜单，然后选择 Apps 和集成 。
点击添加应用 。
输入应用名称，从列表中选择该应用，然后点击添加 。
针对您要添加 Chat 应用的每个聊天室或私信，重复上述步骤。
从 Chat 聊天室中移除旧的 Chat 应用
前往 Chat。
点击私信或聊天室。
点击聊天室或人员名称旁边的下拉菜单，然后选择 Apps 和集成 。
在旧的未迁移的 Chat 应用旁边，点击 更多选项 ，然后点击 从聊天室中移除。
针对您要从中移除旧 Chat 应用的每个聊天室或私信，重复上述步骤。
关闭旧的 Chat 应用
如要禁止用户使用旧的 Chat 应用 并鼓励他们使用新的 Chat 应用， 请关闭旧的 Chat 应用并将其从 Google Workspace Marketplace 中取消发布。