合併 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 應用程式。
在已合併的機構中建立 Cloud 專案並啟用 API
在合併的 Google Workspace 機構中，建立新的 Cloud 專案並啟用 Chat 應用程式的 API，可確保您授予 Chat 應用程式存取權的使用者和群組能夠順利執行。
建立 Cloud 專案
Google Cloud 控制台
- 在 Google Cloud 控制台中，依序點選「選單」圖示 >「IAM 與管理」>「建立專案」。
-
在「Project Name」欄位中，輸入專案的描述性名稱。
選用：如要編輯專案 ID，請按一下「Edit」。專案建立後即無法變更專案 ID，因此請在專案生命週期內選擇符合您需求的 ID。
- 在「位置」欄位中，按一下「瀏覽」，查看專案的潛在位置。然後按一下「選取」。
- 點選「建立」。Google Cloud 控制台會前往「資訊主頁」頁面，並在幾分鐘內建立專案。
gcloud CLI
在下列其中一種開發環境中，存取 Google Cloud CLI (「gcloud)：
-
Cloud Shell：如要在已設定 gcloud CLI 中使用線上終端機，請啟用 Cloud Shell。
啟用 Cloud Shell -
本機殼層：如要使用本機開發環境，請安裝並initialize gcloud CLI。
如要建立 Cloud 專案，請使用「gcloud projects create」指令：
取代 PROJECT_ID，為要建立的專案設定 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 專案中啟用的新 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
設定 OAuth 同意畫面
您可能需要為 Cloud 專案設定 OAuth 同意畫面。如果您先前使用 OAuth 2.0 進行授權，請使用相同的存取權授權範圍。
- 在 Google Cloud 控制台中，依序點選「選單」圖示 >「API 和服務」>「OAuth 同意畫面」。
- 選取應用程式的使用者類型，然後按一下「Create」。
- 填寫應用程式註冊表單，然後按一下「儲存並繼續」。
如要建立可在 Google Workspace 機構外部使用的應用程式，請按一下「新增或移除範圍」。建議您在選取範圍時採用以下最佳做法：
- 選取提供應用程式所需最低存取權範圍的範圍。如需可用範圍的清單，請參閱 Google API 適用的 OAuth 2.0 範圍。
- 查看以下三個區段列出的範圍：非機密範圍、敏感範圍及受限制的範圍。針對「您的機密範圍」或「您的受限制範圍」部分中列出的任何範圍，請找出其他的非機密範圍，避免進行不必要的額外審查。
- 部分範圍需要 Google 進行額外審查。如果應用程式只會在您的 Google Workspace 機構內部使用，同意畫面就不會列出範圍，而使用受限製或敏感範圍的應用程式並不需要經過 Google 進一步審查。詳情請參閱「範圍類別」相關說明。
- 選取應用程式所需的範圍後，請按一下「儲存並繼續」。
- 針對使用者類型選取「外部」，請新增測試使用者：
- 在「測試使用者」下方，點選「新增使用者」。
- 輸入您的電子郵件地址和任何其他授權測試使用者，然後按一下「儲存並繼續」。
- 查看您的應用程式註冊摘要。如要變更，請按一下「編輯」。如果應用程式註冊正確無誤，請按一下「Back to Dashboard」(返回資訊主頁)。
將 Chat 應用程式重新部署至新的 Cloud 專案
根據您的 Chat 應用程式是以 Apps Script、AppSheet 或其他連線類型 (例如 Python 或 Java) 建構而成，重新部署 Chat 應用程式的作業有極大差異。無論是哪一種情況，您都不需要重新建立所有程式碼，但必須進行一些變更。
遷移 Chat 應用程式邏輯
視 Chat 應用程式的架構而定，您可能需要將其他服務遷移至新的 Cloud 專案：
- 針對 HTTP 應用程式，您也必須遷移使用 Cloud Functions、Cloud Run 或 App Engine 建構的應用程式邏輯的其餘部分。
- 如果是使用自然語言的對話式 Chat 應用程式，您還需要遷移 Dialogflow 代理程式。
- 如果是在防火牆後方建構的即時通訊應用程式，您還需要遷移 Pub/Sub 主題。
在新的 Cloud 專案中設定 Chat 應用程式
如要重新部署以 Python 或 Java 等語言建構的 Chat 應用程式，請在新的 Cloud 專案中設定 Chat 應用程式。
在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」和「管理」。
按一下「Configuration」分頁標籤，然後輸入下列必要資訊：
- 應用程式名稱：使用者與您的 Chat 應用程式互動時使用的名稱。
- 顯示圖片網址：指向 Chat 應用程式顯示圖片的 HTTPS 網址 (例如 PNG 或 JPEG)，至少 128x128。
- 說明：Chat 應用程式預期用途的說明，會顯示在 Chat 應用程式名稱下方。
如要開啟互動功能，請按一下「啟用互動式功能」切換鈕，讓使用者與您的 Chat 應用程式互動，並使用下表完成設定：
欄位 說明 功能 這組欄位會決定 Chat 應用程式如何與使用者互動： - 接收 1:1 訊息：使用者可以直接在 Google Chat 中找到 Chat 應用程式並傳送訊息給對方。
- 加入聊天室和群組對話：使用者可將 Chat 應用程式新增至聊天室和群組對話。
連線設定 Chat 應用程式的端點，會是下列其中一種： - 應用程式網址：代管 Chat 應用程式實作項目的 HTTPS 端點。
- Apps Script 專案：實作 Chat 應用程式的 Apps Script 專案部署作業 ID。
- Cloud Pub/Sub 主題名稱：Chat 應用程式以端點形式訂閱的 Pub/Sub 主題。
- Dialogflow：透過 Dialogflow 整合註冊 Chat 應用程式。詳情請參閱「建構能理解自然語言的 Dialogflow Google Chat 應用程式」。
斜線指令 可在 Google Chat 中向使用者顯示的指令。允許使用者在 Google Chat 中查看 Chat 應用程式的核心動作，並選擇要互動的特定動作。詳情請參閱「以 Chat 應用程式的形式回應斜線指令」。 連結預覽 Chat 應用程式可辨識的網址模式，並在使用者傳送連結時提供額外內容。詳情請參閱「預覽連結」。 能見度 最多 5 人或一或多個 Google 群組，可以查看及安裝 Chat 應用程式。請使用這個欄位測試 Chat 應用程式，或是將 Chat 應用程式分享給團隊成員。詳情請參閱「Chat 應用程式的顯示和發布設定」。 如要在 Chat 應用程式傳回錯誤時將錯誤記錄到 Cloud Logging，請勾選「Log errors to Logging」(將錯誤記錄至 Logging) 核取方塊。詳情請參閱「查詢即時通訊應用程式的錯誤記錄」。
按一下「儲存」。當您儲存 Chat 應用程式設定後，Google Workspace 機構中的指定使用者就能使用您的 Chat 應用程式。
重新部署 Apps Script Chat 應用程式
如要重新部署使用 Apps Script 建構的 Chat 應用程式，請將 Apps Script 專案與現有 Cloud 專案相關聯的 Cloud 專案編號變更為相關聯的 Cloud 專案編號。接著，請複製 Apps Script 部署 ID，並貼到 Google Cloud 控制台的 Chat 應用程式設定頁面。
複製 Cloud 專案編號
- 在 Google Cloud 控制台中，依序點選「選單」圖示 >「IAM 與管理」>「設定」。
- 複製「Project number」欄位中的值。
在 Apps Script 專案中設定 Google Cloud 專案編號
前往 Apps Script。
在 Chat 應用程式的 Apps Script 專案中，按一下「專案設定」圖示 。
按一下「Google Cloud Platform (GCP) 專案」下方的「變更專案」。
在「GCP 專案編號」中貼上 Google Cloud 專案編號。
按一下「設定專案」。
複製 Apps Script 專案的部署作業 ID
- 在 Apps Script 的右上方，依序點選「部署」>「管理部署作業」。
- 按一下「Deployment ID」下方的「Copy」。
- 按一下「完成」。
重新設定及重新部署 Chat 應用程式
在 Google Cloud 控制台中搜尋「Google Chat API」，然後依序點選「Google Chat API」和「管理」。
按一下「Configuration」分頁標籤，然後輸入下列必要資訊：
- 應用程式名稱：使用者與您的 Chat 應用程式互動時使用的名稱。
- 顯示圖片網址：指向 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 應用程式。詳情請參閱「Google Workspace 管理員如何安裝 Chat 應用程式」。
改用新版 Chat 應用程式
現在 Chat 應用程式已遷移至新機構後 就可以開始公開發布了請將 SDK 加入 Chat 聊天室或即時訊息，然後再從中移除舊的 Chat 應用程式，讓使用者只向遷移的 Chat 應用程式傳送訊息。
將新的 Chat 應用程式新增至 Chat 聊天室
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式與整合」。
按一下「新增應用程式」。
輸入應用程式名稱，從清單中選取應用程式，然後按一下「新增」。
針對您要新增 Chat 應用程式的每個聊天室或即時訊息重複上述步驟。
從 Chat 聊天室中移除舊版 Chat 應用程式
前往 Chat。
按一下即時訊息或聊天室。
按一下聊天室或使用者名稱旁的下拉式選單，然後選取「應用程式與整合」。
在尚未遷移的舊版 Chat 應用程式旁邊，依序按一下「More options」圖示 和「Remove from space」。
針對要從舊版 Chat 應用程式中移除的每個聊天室或即時訊息重複上述步驟。
關閉舊版 Chat 應用程式
如要禁止使用者使用舊版 Chat 應用程式，並鼓勵他們使用新版 Chat 應用程式，請關閉舊版 Chat 應用程式，再從 Google Workspace Marketplace 取消發布。