如果合併 Google Workspace 機構，您可能需要遷移 Chat 應用程式，才能繼續使用。
遷移 Chat 應用程式前，請先向貴機構的管理員確認管理設定是否會影響遷移作業。變更管理設定後，Chat 應用程式可能就會恢復完整功能，因此不需要遷移。舉例來說，Google Workspace 管理員可能必須將 Chat 應用程式加入許可清單，或允許使用者安裝 Chat 應用程式。詳情請參閱「判斷合併 Google Workspace 機構後是否需要遷移 Google Chat 應用程式」。
確定需要遷移 Google Chat 應用程式後，請完成下列三步驟程序：
- 在合併的機構中建立 Google Cloud 專案、啟用 API，並視需要設定 OAuth 2.0 同意畫面，為 Chat 應用程式設定環境。
- 從新的 Cloud 專案重新部署 Chat 應用程式。
- 將重新建立的 Chat 應用程式加入 Chat 聊天室或對話，然後關閉原始的 Chat 應用程式。
在合併的機構中建立 Cloud 專案並啟用 API
在合併的 Google Workspace 機構中，為 Chat 應用程式建立新的 Cloud 專案並啟用 API，確保允許存取 Chat 應用程式的使用者和群組可以順利存取。
建立 Cloud 專案
Google Cloud 控制台
- 前往 Google Cloud 控制台，依序點選「選單」圖示 >「IAM 與管理」 >「建立專案」。
-
在「Project Name」(專案名稱) 欄位中，輸入專案的描述性名稱。
選用：如要編輯「專案 ID」，請按一下「編輯」。專案建立後就無法變更專案 ID，因此請選用符合專案執行期間需求的 ID。
- 在「Location」(位置) 欄位中，按一下「Browse」(瀏覽)，顯示專案的可能位置。然後按一下「選取」。
- 按一下「建立」，Google Cloud 控制台會前往「資訊主頁」頁面，並在幾分鐘內建立專案。
gcloud CLI
在下列任一開發環境中，存取 Google Cloud CLI (gcloud)：
-
Cloud Shell：如要使用已設定 gcloud CLI 的線上終端機，請啟用 Cloud Shell。
啟用 Cloud Shell -
本機殼層：如要使用本機開發環境，請安裝並初始化 gcloud CLI。
如要建立 Cloud 專案，請使用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。為確保遷移的應用程式正常運作，建議您在新 Cloud 專案中啟用與舊 Cloud 專案相同的 API。
如要啟用 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 同意畫面。如果您先前使用 OAuth 2.0 授權，請使用相同的授權存取範圍。
- 在 Google Cloud 控制台中，依序前往「選單」 > >「品牌」。
- 如果您已設定 ，可以在「品牌」、「目標對象」和「資料存取」中設定下列 OAuth 同意畫面。 如果看到「尚未設定」 訊息，請按一下「開始使用」：
- 在「App Information」(應用程式資訊) 下方的「App name」(應用程式名稱) 欄位中，輸入應用程式名稱。
- 在「使用者支援電子郵件」中，選擇支援電子郵件地址，方便使用者在同意聲明方面有任何疑問時與您聯絡。
- 點選 [下一步]。
- 在「目標對象」下方，選取應用程式的使用者類型。
- 點選 [下一步]。
- 在「聯絡資訊」下方，輸入可接收專案異動通知的電子郵件地址。
- 點選 [下一步]。
- 在「完成」下方，詳閱《Google API 服務：使用者資料政策》，然後選取「我同意《Google API 服務：使用者資料政策》」。
- 按一下 [繼續]。
- 按一下「Create」(建立)。
- 如果為使用者類型選取「外部」，請新增測試使用者：
- 按一下「目標對象」。
- 在「測試使用者」下方，按一下「新增使用者」。
- 輸入您的電子郵件地址和任何其他授權測試使用者，然後按一下「儲存」。
如要建立供 Google Workspace 機構外部使用的應用程式，請依序點選「資料存取」>「新增或移除範圍」。選取範圍時，建議採取下列最佳做法：
- 選取應用程式所需的最低存取層級範圍。如需可用範圍清單，請參閱「Google API 適用的 OAuth 2.0 範圍」。
- 請查看三個部分列出的範圍：非機密範圍、機密範圍和受限制範圍。如果「您的機密範圍」或「您的受限範圍」部分列出任何範圍，請嘗試找出替代的非機密範圍，避免不必要的額外審查。
- 部分範圍需要 Google 進行額外審查。如果應用程式僅供 Google Workspace 機構內部使用，同意畫面就不會列出範圍，且使用受限制或敏感範圍時，也不需要 Google 進一步審查。詳情請參閱範圍類別。
- 選取應用程式所需的範圍後，按一下「儲存」。
如要進一步瞭解如何設定 OAuth 同意畫面，請參閱「開始使用 」一文。
將 Chat 應用程式重新部署至新的 Cloud 專案
視 Chat 應用程式是使用 Apps Script、AppSheet 或其他連線類型 (例如 Python 或 Java) 建構而定，重新部署 Chat 應用程式的方式會略有不同。無論是哪種情況，您都不需要重新建立所有程式碼，但確實需要進行一些變更。
遷移 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 控制台中，依序前往「選單」圖示 >「IAM 與管理」 >「設定」。
- 在「專案編號」欄位中，複製該值。
在 Apps Script 專案中設定 Google Cloud 專案編號
前往 Apps Script。
在 Chat 應用程式的 Apps Script 專案中，按一下「專案設定」圖示 。
在「Google Cloud Platform (GCP) 專案」下方，按一下「變更專案」。
在「GCP 專案編號」中，貼上 Google Cloud 專案編號。
按一下「設定專案」。
複製 Apps Script 專案的部署作業 ID
- 在 Apps Script 的右上角，依序點選「部署」>「管理部署」。
- 按一下「部署 ID」下方的「複製」。
- 按一下 [完成]。
重新設定及重新部署 Chat 擴充應用程式
在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」和「管理」。
按一下「Configuration」(設定) 分頁標籤，然後輸入下列必要資訊：
- 應用程式名稱：使用者與 Chat 應用程式互動時使用的名稱。
- 顯示圖片網址：指向正方形圖片 (例如 PNG 或 JPEG) 的 HTTPS 網址，大小至少為 128x128，會顯示為 Chat 應用程式的顯示圖片。
- 說明：說明 Chat 應用程式的預期用途，會顯示在 Chat 應用程式名稱下方。
如要開啟互動功能，請點按「啟用互動功能」切換鈕，讓使用者與 Chat 應用程式互動：
在「連線設定」下方，選取「Apps Script 專案」。
在「Deployment ID」欄位中，貼上您先前複製的部署作業 ID。
如要完成其餘設定，請參閱「在新 Cloud 專案中設定 Chat 擴充應用程式」一文中的表格
按一下 [儲存]。
重新部署 AppSheet Chat 擴充應用程式
如要在新的 Cloud 專案中重新部署以 AppSheet 建構的 Chat 應用程式，請將應用程式複製到新的 Cloud 專案。
更新服務帳戶
如果您的 Chat 應用程式是以應用程式身分驗證，並使用服務帳戶呼叫 Google API，請更新 Chat 應用程式的服務帳戶詳細資料。詳情請參閱「以 Chat 專用應用程式身分進行驗證」。
分享 Chat 應用程式
在新的機構中，使用者必須先取得管理員手動授予的存取權，才能使用即時通訊應用程式。詳情請參閱 Google Workspace Marketplace 說明文件中的「為 Google Workspace 機構設定存取權」。
改用新版 Chat 應用程式
現在 Chat 應用程式已遷移至新機構，接下來請公開發布。將新版 Chat 應用程式加入 Chat 聊天室或即時訊息，然後從中移除舊版 Chat 應用程式，確保使用者只會透過已遷移的 Chat 應用程式傳送訊息。
將新的 Chat 應用程式新增至 Chat 聊天室
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式和整合」。
按一下「新增應用程式」。
輸入應用程式名稱，從清單中選取應用程式，然後按一下「新增」。
針對要新增 Chat 應用程式的每個聊天室或即時訊息對話，重複上述步驟。
從 Chat 聊天室中移除舊版 Chat 應用程式
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式和整合」。
在舊版未遷移的 Chat 應用程式旁邊，按一下「更多選項」，然後按一下「從聊天室中移除」。
針對要移除舊版 Chat 應用程式的每個聊天室或即時訊息，重複執行上述步驟。
關閉舊版 Chat 應用程式
如要禁止使用者使用舊版 Chat 應用程式，並鼓勵他們改用新版 Chat 應用程式，請關閉舊版 Chat 應用程式，並從 Google Workspace Marketplace 取消發布。