如果您合并了 Google Workspace 组织，则可能需要将您的 Chat 扩展应用，以便其能够继续运行。
在迁移 Chat 应用之前，请与您的 组织管理员可查看管理设置是否 影响。更改管理设置可能会恢复已满 对 Chat 应用进行一些迁移 不需要。例如，您的 Google Workspace 管理员可能 将您的 Chat 应用添加到许可名单，或者可能必须 允许用户安装 Chat 扩展应用。如需了解详情，请参阅 确定在合并 Google Workspace 组织后是否需要迁移 Google Chat 应用。
在您确定需要迁移 Chat 应用需完成以下三个步骤：
- 为您的 Chat 应用设置环境，具体操作步骤如下： 在合并后的组织中创建 Google Cloud 项目，启用 API，以及 配置 OAuth 2.0 权限请求页面。
- 通过新版 Google Chat 应用重新部署您的 Chat 应用 Cloud 项目中。
- 将重新创建的 Chat 应用添加到 Chat 聊天室或对话，关闭原始聊天室 Chat 应用。
在合并的组织中创建 Cloud 项目并启用 API
创建新的 Cloud 项目并启用 API 合并后的 Google Workspace 组织中的 Chat 应用 请确保您授予了访问权限的用户和群组 Chat 应用可以正常运行而不出现错误。
创建 Cloud 项目
Google Cloud 控制台
- 在 Google Cloud 控制台中，点击“菜单”图标 > IAM 和管理 > 创建项目。
-
在项目名称字段中，为您的项目输入描述性名称。
可选：要修改项目 ID，请点击修改。项目 ID 无法更改 创建项目后，请选择一个满足您需求的 ID 项目。
- 在地理位置字段中，点击浏览以显示适合您的潜在地理位置 项目。然后，点击选择。 <ph type="x-smartling-placeholder">
- 点击创建。Google Cloud 控制台会转到“信息中心”页面，并且您的项目已创建完毕 就会出现这种问题
gcloud CLI
在以下某个开发环境中，访问 Google Cloud CLI (`gcloud`)：
-
Cloud Shell：通过 gcloud CLI 使用在线终端
请激活 Cloud Shell。
激活 Cloud Shell -
Local Shell：如需使用本地开发环境，
安装和
初始化
gcloud CLI
如需创建 Cloud 项目，请使用“gcloud projects create”命令：
通过设置要创建的项目的 ID 来替换 PROJECT_ID。gcloud projects create PROJECT_ID
启用 API
所有聊天应用都必须拥有 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最佳做法是，确保 迁移后的应用是否正常运行，请在新的 Cloud 项目中启用与 旧 Cloud 项目中已启用的功能。
如需启用 API，请执行以下操作：
Google Cloud 控制台
- 在 Google Cloud 控制台中，点击“菜单”图标 > 更多产品 > Google Workspace > 产品库。
- 点击您要启用的 API。
- 点击启用。
- 如需启用更多 API，请重复上述步骤。
Google Cloud CLI
- 安装或打开 Google Cloud 命令行界面 (CLI)。
-
运行
services enable命令，指定要启用的 API 服务。gcloud services enable API_SERVICE_ID
配置 Chat API
在新的 Cloud 项目中，您必须使用 Chat API 执行以下操作： 指定您的 Chat 应用的名称、说明和图标。接收者 配置这些详细信息，请参阅 配置 Chat API
配置 OAuth 权限请求页面
您可能需要为您的 Cloud 项目中。如果您之前使用 OAuth 2.0 进行授权，请使用 相同的访问授权范围。
- 在 Google Cloud 控制台中，点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
- 为应用选择用户类型，然后点击创建。
- 填写应用注册表单，然后点击保存并继续。
如果您要创建用于 Google Workspace 以外的应用 组织，请点击添加或移除范围。我们建议在 选择范围：
- 选择提供应用所需的最低访问权限级别的范围。有关 可用的范围，请参阅 Google API 的 OAuth 2.0 范围。
- 请查看以下三个部分列出的范围：非敏感 范围、敏感范围和受限范围。对于 “您的敏感范围”或“您的受限范围”部分，尝试找出 替代非敏感范围，以避免不必要的额外审核。
- 部分范围需要经过 Google 的额外审核。仅限使用的应用 范围未列出 同意屏幕以及使用受限范围或敏感范围均不要求 由 Google 进一步审核。如需了解详情，请参阅 范围类别。
- 选择所需范围后 点击 Save and Continue（保存并继续）。
- 如果您选择了外部作为用户类型，请添加测试用户：
<ph type="x-smartling-placeholder">
- </ph>
- 在测试用户下，点击添加用户。
- 输入您的电子邮件地址和任何其他获授权的测试用户，然后点击 保存并继续。
- 查看应用注册摘要。如需进行更改，请点击修改。如果应用 点击 Back to Dashboard（返回信息中心）。
将您的 Chat 应用重新部署到新的 Cloud 项目
具体取决于您的 Chat 应用的构建方式 Apps 脚本、AppSheet 或其他连接类型，例如 Python 或 Java，那么重新部署您的 Chat 应用会 就很少了无论是哪种情况，您都不需要重新创建所有代码 需要进行一些更改
迁移 Chat 应用逻辑
根据 Chat 应用的架构中， 您可能需要将其他服务迁移到新的 Cloud 项目：
- 对于 HTTP 应用，您还需要迁移其余的应用逻辑， 使用 Cloud Functions、Cloud Run 或 App Engine 构建而成。
- 对于使用自然语言的对话式 Chat 扩展应用，您可以 还需要迁移 Dialogflow 代理。
- 对于受防火墙保护的聊天应用，您还可以 迁移 Pub/Sub 主题。
在新 Cloud 项目中配置交互式功能
重新部署使用某种语言构建的 Chat 应用 （例如 Python 或 Java），请在 创建新的 Google Cloud 项目
如需配置互动功能，请参阅 接收和响应用户互动。
重新部署 Apps 脚本聊天应用
要重新部署使用 Apps 脚本，请将 Cloud 项目编号更改为 Apps 脚本项目所关联的项目编号 属于您的新 Cloud 项目。然后，将 Apps 脚本部署 ID 并将其粘贴到 Google Cloud 控制台中的 Chat 应用配置页面。
复制 Cloud 项目编号
- 在 Google Cloud 控制台中，点击“菜单”图标 > IAM 和管理 > 设置。
- 复制项目编号字段中的值。
在 Apps 脚本项目中设置 Google Cloud 项目编号
前往 Apps 脚本。
在 Chat 应用的 Apps 脚本项目中， 点击 Project Settings 图标 。
在 Google Cloud Platform (GCP) 项目下，点击更改项目。
在 GCP 项目编号中，粘贴 Google Cloud 项目编号。
点击设置项目。
复制 Apps 脚本项目的部署 ID
- 在 Apps 脚本的右上方，点击 部署 >管理部署。
- 在部署 ID 下，点击复制。
- 点击完成。
重新配置并重新部署您的 Chat 应用
在 Google Cloud 控制台中，搜索“Google Chat API”并点击 Google Chat API，然后点击管理。
点击配置标签页，然后输入以下信息 信息：
- 应用名称：用户在与您的 Google Play 应用 Chat 应用。
- 头像网址：指向方形图形图片的 HTTPS 网址 （例如，PNG 或 JPEG），尺寸至少为 128x128，以 您的 Chat 应用的头像。
- 说明：对 Chat 应用的预期用途 。
要启用互动功能，请点击启用互动功能 可让用户与您的 Chat 应用：
在“连接设置”下，选择 Apps 脚本项目。
在部署 ID 字段中，粘贴您之前的部署 ID 已复制。
要完成其余配置，请查看 在新的 Cloud 项目中配置 Chat 应用
点击保存。
重新部署 AppSheet Chat 应用
要重新部署使用 创建好 AppSheet 将应用复制到新的 Cloud 项目。
更新服务账号
如果您的 Chat 应用通过了应用的身份验证，并使用 来调用 Google API、更新 Chat 应用的服务账号详细信息。有关 请参阅 作为 Chat 应用进行身份验证。
共享 Chat 应用
您的 Chat 应用面向以下国家/地区的用户提供之前 新组织，您的 管理员可能必须手动允许访问 Chat 应用。如需更多信息 参阅 Google Workspace 管理员如何安装 Chat 扩展应用。
改用新版 Chat 应用
现在，Chat 应用已迁移到新版 就可以公开宣传了将对话添加到 Chat 聊天室 或私信，然后移除旧版 Chat 应用 这样，其他人就可以只向已迁移的 Chat 应用。
<ph type="x-smartling-placeholder">将新版 Chat 应用添加到 Chat 聊天室
前往 Chat。
点击私信或聊天室。
点击相应聊天室或人员名称旁边的下拉菜单，然后 选择应用和集成。
点击添加应用。
输入应用名称，从列表中选择应用，然后点击 添加。
针对要添加的每个聊天室或私信重复上述步骤 。
从 Chat 聊天室中移除旧版 Chat 应用
前往 Chat。
点击私信或聊天室。
点击相应聊天室或人员名称旁边的下拉菜单，然后 选择应用和集成。
在未迁移的旧版 Chat 应用旁边，点击 更多选项 ，然后点击 从聊天室中移除。
针对您要移除的每个聊天室或私信重复上述步骤 旧版 Chat 应用。
关闭旧版 Chat 应用
禁止用户使用旧版 Chat 应用 并鼓励他们使用新版 Chat 应用 停用旧版 Chat 扩展应用，并在 Google Workspace Marketplace 中取消发布该应用。