如果合併 Google Workspace 機構，您可能需要將 確保能繼續運作的即時通訊應用程式。
遷移 Chat 應用程式前，請先確認 機構管理員可查看管理設定， 並對此完全毫無影響變更管理設定可能會還原完整內容 以便遷移及遷移 不需要。舉例來說，您的 Google Workspace 管理員 將 Chat 應用程式加入許可清單 讓使用者安裝 Chat 擴充應用程式。若需更多資訊，請參閲 決定在合併 Google Workspace 機構後，是否需要遷移 Google Chat 應用程式。
當您確定要遷移 Chat 應用程式會執行下列三個步驟：
- 如要設定 Chat 應用程式的環境，請按照下列步驟操作： 在合併的機構中建立 Google Cloud 專案並啟用 API，以及 可能會設定 OAuth 2.0 同意畫面
- 透過新版本 Cloud 專案
- 將重新建立的 Chat 擴充應用程式新增至 Chat 聊天室或對話，並關閉原始群組 Chat 應用程式。
在合併的機構中建立 Cloud 專案並啟用 API
建立新的 Cloud 專案並啟用 API 合併後的 Google Workspace 機構中的即時通訊應用程式 請確保您授予應用程式存取權的使用者和群組 Chat 應用程式可以避免發生錯誤。
建立 Cloud 專案
Google Cloud 控制台
- 在 Google Cloud 控制台中，前往「選單」圖示 > IAM 與管理員 > 建立專案。
-
在「Project Name」(專案名稱) 欄位，輸入專案的描述性名稱。
選用：如要編輯「專案 ID」，請按一下「編輯」。無法變更專案 ID 因此請在專案建立後根據 專案。
- 按一下「地區」欄位中的「瀏覽」，即可查看可能的地理位置 專案。然後按一下「選取」。
- 點選「建立」。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
所有 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 專案中啟用相同的 API， 會在舊版 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 審查若需更多資訊，請參閲 範圍類別。
- 選取需要的範圍後 請按一下「儲存並繼續」。
- 如果您為使用者類型選取「外部」，請新增測試使用者：
- 在「測試使用者」下方，按一下「新增使用者」。
- 輸入您的電子郵件地址和其他任何授權測試使用者，然後按一下 儲存並繼續。
- 查看應用程式註冊摘要。如要修改資訊，請按一下「編輯」。如果應用程式 註冊看起來沒有問題，請按一下 [返回資訊主頁]。
將 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 專案中設定互動式功能
如何重新部署以特定語言建構的 Chat 擴充應用程式 例如 Python 或 Java，請在 新的 Cloud 專案
如要設定互動功能，請參閱 接收及回覆使用者互動。
重新部署 Apps Script Chat 應用程式
如何重新部署透過 Apps Script，請將應用程式的 Cloud 專案編號 Apps Script 專案會與以下專案編號建立關聯 就屬於新的 Cloud 專案然後複製 Apps Script 部署作業 ID 並貼到 Google Cloud 控制台中的即時通訊應用程式設定頁面。
複製 Cloud 專案編號
- 在 Google Cloud 控制台中，前往「選單」圖示 > IAM 與管理員 >「設定」。
- 複製「Project number」欄位中的值。
在 Apps Script 專案中設定 Google Cloud 專案編號
前往 Apps Script。
在 Chat 應用程式 Apps Script 專案中， 按一下「Project Settings」圖示 。
在「Google Cloud Platform (GCP) Project」(Google Cloud Platform (GCP) 專案) 下方，按一下 [變更專案]。
在「GCP 專案編號」中，貼上 Google Cloud 專案編號。
按一下「設定專案」。
複製 Apps Script 專案的部署作業 ID
- 在 Apps Script 右上方，按一下 部署 >管理部署作業。
- 按一下「部署作業 ID」下方的「複製」。
- 按一下 [完成]。
重新設定及重新部署 Chat 應用程式
在 Google Cloud 控制台中搜尋「Google Chat API」然後按一下 Google Chat API，然後點選「管理」。
按一下「Configuration」分頁標籤，然後輸入下列必要項目 每個 ACL 都由一或多個項目組成 而這些項目包含兩項資訊
- 應用程式名稱：使用者與您商家互動時的名稱 Chat 應用程式。
- 顯示圖片網址：指向正方形圖形的 HTTPS 網址 (例如 PNG 或 JPEG) 至少 128x128，在 Chat 應用程式的顯示圖片。
- 說明：對於 Chat 應用程式的預期用途 圖示。
如要開啟互動功能，請按一下「啟用互動功能」 這個切換鈕可讓使用者與 Chat 擴充應用程式：
在「連線設定」下方，選取「Apps Script 專案」。
在「Deployment ID」欄位中貼上您先前的部署作業 ID 已複製。
如要完成其餘設定，請參閱 在新 Cloud 專案中設定 Chat 應用程式
按一下 [儲存]。
重新部署 AppSheet Chat 應用程式
如何重新部署透過 在新 Cloud 專案中使用 AppSheet 將應用程式複製到新的 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 應用程式 關閉舊版 Chat 擴充應用程式，並從 Google Workspace Marketplace 取消發布。