如果合併 Google Workspace 機構，您可能需要遷移 Chat 應用程式，才能繼續使用。
遷移 Chat 應用程式前，請向貴機構的管理員確認是否有管理設定影響遷移作業。變更管理設定可能會讓 Chat 應用程式恢復完整功能，因此不需要進行遷移。舉例來說，Google Workspace 管理員可能需要將 Chat 應用程式加入許可清單，或是允許使用者安裝 Chat 應用程式。詳情請參閱「決定是否需要在合併 Google Workspace 機構後遷移 Google Chat 應用程式」。
確定需要遷移 Chat 應用程式後，請完成下列三個步驟：
- 在合併的機構中建立 Google Cloud 專案、啟用 API，並視需要設定 OAuth 2.0 同意畫面，為 Chat 應用程式設定環境。
- 從新的 Cloud 專案重新部署 Chat 應用程式。
- 將重新建立的 Chat 應用程式加入 Chat 聊天室或對話，然後關閉原始的 Chat 應用程式。
在合併後的機構中建立 Cloud 專案並啟用 API
建立新的 Cloud 專案，並在合併的 Google Workspace 組織中為 Chat 應用程式啟用 API，可確保您允許存取 Chat 應用程式的使用者和群組不會發生錯誤。
建立 Cloud 專案
- 在 Google Cloud 控制台中，依序前往「選單」 >「IAM 與管理」 >「建立專案」。
-
在「Project Name」欄位中，輸入專案的描述性名稱。
選用步驟：如要編輯專案 ID，請按一下「編輯」。專案建立後就無法變更專案 ID，因此請選用方便您在整個專案執行期間使用的專案 ID。
- 在「Location」欄位中，按一下「Browse」，即可顯示專案的潛在地點。然後按一下「選取」。
- 按一下「建立」，Google Cloud 控制台會前往「Dashboard」(資訊主頁) 頁面，並在幾分鐘內建立專案。
在下列任一開發環境中，存取 Google Cloud CLI (gcloud)：
-
Cloud Shell：如要使用已設定 gcloud CLI 的線上終端機，請啟用 Cloud Shell。
啟用 Cloud Shell -
本機 Shell：如要使用本機開發環境，請安裝並初始化 gcloud CLI。
如要建立 Cloud 專案，請使用gcloud projects create指令：gcloud projects createPROJECT_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。最佳做法是，為了確保遷移的應用程式運作正常，請在新 Cloud 專案中啟用舊 Cloud 專案中啟用的相同 API。
如要啟用 API，請按照下列步驟操作：
- 在 Google Cloud 控制台中，依序前往「選單」 >「更多產品」>「Google Workspace」>「產品目錄」。
- 按一下要啟用的 API。
- 按一下「啟用」。
- 如要啟用更多 API，請重複執行這些步驟。
- 安裝或開啟 Google Cloud 指令列介面 (CLI)。
-
執行
services enable指令，指定要啟用的 API 服務。gcloud services enable
API_SERVICE_ID
設定 Chat API
在新 Cloud 專案中，您必須使用 Chat API 指定 Chat 應用程式的名稱、說明和圖示。如要設定這些詳細資料，請參閱「設定 Chat API」
設定 OAuth 同意畫面
您可能需要為 Cloud 專案設定 OAuth 同意畫面。如果您先前使用 OAuth 2.0 進行授權，請使用相同的授權存取範圍。
- 在 Google Cloud 控制台中，依序前往「選單」 >「」 >「品牌」。
- 如果您已設定 ，則可以在「品牌」、「目標對象」和「資料存取」中設定下列 OAuth 同意畫面設定。 如果畫面上顯示「尚未設定」 ，請按一下「開始使用」：
- 在「App Information」(應用程式資訊) 下方的「App name」(應用程式名稱) 中，輸入「App name」(應用程式名稱)。
- 在「使用者支援電子郵件」中，選擇使用者有同意聲明相關問題時可與您聯絡的支援電子郵件地址。
- 點選 [下一步]。
- 在「目標對象」下方，選取應用程式的使用者類型。
- 點選 [下一步]。
- 在「聯絡資訊」下方，輸入電子郵件地址，以便在專案有任何異動時通知您。
- 點選 [下一步]。
- 在「Finish」下方，詳閱「Google API 服務使用者資料政策」，如果同意，請選取「I agree to the Google API Services: User Data Policy」。
- 按一下 [繼續]。
- 按一下 [建立]。
- 如果您選取的使用者類型為「外部」，請新增測試使用者：
- 按一下「目標對象」。
- 在「測試使用者」下方，點選「新增使用者」。
- 輸入您的電子郵件地址和其他授權測試使用者，然後按一下「儲存」。
如果您要建立的應用程式是用於 Google Workspace 機構以外的環境，請依序點選「資料存取」>「新增或移除範圍」。選擇範圍時，建議您採取下列最佳做法：
- 選取提供應用程式所需最低存取權限的範圍。如需可用範圍的清單，請參閱「Google API 適用的 OAuth 2.0 範圍」。
- 請查看每個部分列出的範圍：非機密範圍、機密範圍和受限制範圍。針對「您的機密範圍」或「您的受限制範圍」部分列出的任何範圍，請盡量找出替代的非機密範圍，以免需要進行額外審查。
- 部分權限需要 Google 額外審查。如果應用程式僅供貴機構的 Google Workspace 使用者在內部使用，同意畫面上不會列出範圍，且使用受限制或敏感範圍時，Google 也不需要進一步審查。詳情請參閱「範圍類別」。
- 選取應用程式所需的權限範圍後，按一下「儲存」。
如要進一步瞭解如何設定 OAuth 同意聲明，請參閱「開始使用 」。
將即時通訊應用程式重新部署至新的 Cloud 專案
視 Chat 應用程式是使用 Apps Script、AppSheet 或其他連線類型 (例如 Python 或 Java) 建構而成而定，重新部署 Chat 應用程式的方式會有些許不同。無論是哪種情況，您都不需要重新建立所有程式碼，但需要進行一些變更。
遷移 Chat 應用程式邏輯
視即時通訊應用程式的架構而定，您可能需要將其他服務遷移至新的 Cloud 專案：
- 如果是 HTTP 應用程式，您還需要遷移使用 Cloud Functions、Cloud Run 或 App Engine 建構的其他應用程式邏輯。
- 如果是使用自然語言的對話式 Chat 應用程式，您也需要遷移 Dialogflow 代理程式。
- 如果 Chat 應用程式是在防火牆後方建構，您也需要遷移 Pub/Sub 主題。
在新的 Cloud 專案中設定互動功能
如要重新部署使用 Python 或 Java 等語言建構的 Chat 應用程式，請在新的 Cloud 專案中設定 Chat 應用程式。
如要設定互動功能，請參閱「接收並回應使用者互動」。
重新部署 Apps Script Chat 應用程式
如要重新部署使用 Apps Script 建構的 Chat 應用程式，請將 Apps Script 專案相關聯的 Cloud 專案編號，變更為屬於新 Cloud 專案的專案編號。接著，複製 Apps Script 部署 ID，並貼到 Google Cloud 控制台的 Chat 應用程式設定頁面。
複製 Cloud 專案編號
- 在 Google Cloud 控制台中，依序前往「Menu」(選單) >「IAM & Admin」(IAM 與管理) >「Settings」(設定)。
- 在「專案編號」欄位中複製值。
在 Apps Script 專案中設定 Google Cloud 專案編號
前往 Apps Script。
在 Chat 應用程式 Apps Script 專案中，按一下「Project Settings」圖示 。
在「Google Cloud Platform (GCP) 專案」下方，按一下「變更專案」。
在「GCP 專案編號」中貼上 Google Cloud 專案編號。
按一下「設定專案」。
複製 Apps Script 專案的部署 ID
- 在 Apps Script 的右上方，依序點選「部署」>「管理部署作業」。
- 按一下「部署 ID」下方的「複製」。
- 按一下 [完成]。
重新設定及重新部署 Chat 應用程式
在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」和「管理」。
按一下「Configuration」分頁標籤，然後輸入下列必要資訊：
- 應用程式名稱：使用者與 Chat 應用程式互動時使用的名稱。
- 顯示圖片網址：HTTPS 網址，指向正方形圖片 (例如 PNG 或 JPEG)，大小至少為 128 x 128，會顯示為 Chat 應用程式的顯示圖片。
- 說明：Chat 應用程式的預期用途說明，會顯示在 Chat 應用程式名稱下方。
如要開啟互動功能，請按一下「啟用互動功能」切換按鈕，讓使用者與 Chat 應用程式互動：
在「連線設定」下方，選取「Apps Script 專案」。
在「Deployment ID」欄位中，貼上先前複製的部署 ID。
如要完成其他設定，請參閱「在新的 Cloud 專案中設定 Chat 應用程式」一文中的表格
按一下 [儲存]。
重新部署 AppSheet Chat 應用程式
如要在新的 Cloud 專案中重新部署使用 AppSheet 建構的 Chat 應用程式，請將應用程式複製到新的 Cloud 專案。
更新服務帳戶
如果 Chat 應用程式以應用程式身分進行驗證，並使用服務帳戶呼叫 Google API，請更新 Chat 應用程式的服務帳戶詳細資料。詳情請參閱「以 Chat 應用程式身分進行驗證」。
分享 Chat 應用程式
在 Chat 應用程式可供新機構的使用者使用之前，管理員可能必須手動允許存取 Chat 應用程式。詳情請參閱「Google Workspace 管理員如何安裝 Chat 應用程式」。
改用新版 Chat 應用程式
即時通訊應用程式已遷移至新機構，現在是時候發布應用程式了。將其加入 Chat 聊天室或即時訊息，然後從這些聊天室或即時訊息中移除舊版 Chat 應用程式，讓使用者只透過遷移的 Chat 應用程式傳送訊息。
將新的 Chat 應用程式新增至 Chat 聊天室
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式與整合」。
按一下「新增應用程式」。
輸入應用程式名稱，從清單中選取應用程式，然後按一下「新增」。
針對要新增 Chat 應用程式的每個聊天室或即時訊息重複上述步驟。
從 Chat 聊天室中移除舊版 Chat 應用程式
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式與整合」。
在未遷移的舊版 Chat 應用程式旁邊，依序按一下「更多選項」圖示 和「從聊天室中移除」。
針對要移除舊版 Chat 應用程式的每個聊天室或即時訊息重複執行這些步驟。
關閉舊版 Chat 應用程式
如要禁止使用者使用舊版 Chat 應用程式，並鼓勵他們使用新版 Chat 應用程式，請關閉舊版 Chat 應用程式，並從 Google Workspace Marketplace 中取消發布。