設定 Google Chat 的 OAuth

本頁說明如何設定 OAuth，將 Google Chat 連結至 Gemini Enterprise 做為資料儲存庫。

設定 Google Chat 的驗證和權限

如要啟用 Google Chat 動作， Google Cloud 管理員必須執行下列步驟，啟用 Google Chat API 並設定驗證。

啟用 Google Chat API

在 Google Cloud 控制台專案中啟用 Google Chat API。

設定應用程式

1. 啟用 API 後，請前往「設定」分頁，然後依下列方式設定應用程式詳細資料：

   • 應用程式名稱：輸入應用程式名稱 (例如 Gemini Enterprise)。應用程式傳送訊息時，使用者會看到這個名稱。
   • 顯示圖片網址：提供 Gemini Enterprise 圖示的網址。這個圖示會顯示在即時通訊討論串的應用程式名稱旁。
   • 說明：輸入說明 (例如 Google Chat app for Gemini Enterprise)。

2. 在「應用程式狀態」下方，確認狀態已設為「已發布」。

3. 按一下 [儲存]。

建立 OAuth 應用程式並新增範圍

如果沒有 OAuth 應用程式，請按照下列步驟操作。如果您已有 OAuth 應用程式，請跳至「建立 OAuth 用戶端憑證」。

1. 前往 Google Auth Platform >「總覽」。

   前往 Auth Platform

2. 按一下「開始使用」。

3. 輸入 OAuth 應用程式的名稱。

4. 在「User support email」(使用者支援電子郵件) 中，選取支援電子郵件地址，方便應用程式使用者在同意聲明方面有任何疑問時與您聯絡。

5. 在「目標對象」下方，選取應用程式的使用者類型：

   • 外部：如果您要建立的應用程式供 Google Workspace 機構外部使用，請選取「外部」。這樣一來，擁有 Google 帳戶的所有使用者都能公開存取應用程式。 如果選取「外部」，請新增測試使用者：
     1. 按一下「目標對象」。
     2. 在「測試使用者」下方，按一下「新增使用者」。
     3. 輸入您的電子郵件地址和其他授權測試使用者，然後按一下「儲存」。
   • 內部：如果應用程式僅供特定 Google Cloud 機構成員使用，請選取「內部」，這樣只有 Google Workspace 機構成員可以存取。

6. 點選「下一步」。

7. 在「聯絡資訊」下方，輸入可接收專案異動通知的電子郵件地址。

8. 點選「下一步」。

9. 在「完成」部分，請詳閱《Google API 服務使用者資料政策》。如果同意，請選取「我同意《Google API 服務：使用者資料政策》」。

10. 按一下「繼續」。

11. 點選「建立」。

建立應用程式後，您可以在「Branding」(品牌) 和「Audience」(目標對象) 中更新 OAuth 同意畫面設定。

新增範圍

如要新增最低必要範圍，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「選單」圖示 menu。
2. 選取導覽選單中的「資料存取權」。
3. 按一下「新增或移除範圍」。
4. 在「手動新增範圍」下方，根據需求貼上 Google Chat 的下列範圍：

連線模式	範圍	目的
聯合搜尋	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly	搜尋及擷取內容所需的最低權限。允許資料存放區列出空間及讀取訊息。
聯合搜尋和動作	https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages.readonly
	https://www.googleapis.com/auth/chat.spaces.create	建立聊天室：建立聊天室所需的最低範圍。
	https://www.googleapis.com/auth/chat.messages.create	訊息：回覆即時通訊討論串所需的最低範圍。

5. 依序按一下「新增至表格」和「更新」。

6. 按一下 [儲存]。

建立 OAuth 用戶端憑證

以下程序說明如何為動作建立新的 OAuth 用戶端 ID。 Google Cloud如果您已有 Google Cloud 動作的 OAuth 用戶端 ID，可以將該用戶端 ID 和密鑰用於 Google Chat 動作，不必建立新的。

1. 前往 Google Auth Platform / Clients。

2. 按一下「建立用戶端」。

3. 「應用程式類型」請選取「網頁應用程式」。

4. 在「Name」(名稱) 欄位中，輸入憑證名稱。

5. 略過「已授權的 JavaScript 來源」。

6. 在「已授權的重新導向 URI」部分，點按「新增 URI」，然後輸入下列 URI： https://vertexaisearch.cloud.google.com/oauth-redirect

7. 點按「Create」(建立)。新建立的憑證會顯示在「OAuth 2.0 Client IDs」下方。開啟剛建立的用戶端，然後複製下列資訊：

   • 用戶端 ID
   • 用戶端密鑰