本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Google Chat 整合
<a name="google-chat-integration"></a>

使用 Google Chat 動作連接器，您可以透過自然語言直接從 Google Workspace 帳戶傳送訊息、管理空間，以及與聊天執行緒互動。

Google Chat 使用自訂 OAuth 應用程式身分驗證。如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="google-chat-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 作用中的 Google Workspace 帳戶，可存取您要使用的 Google Chat 空間。
+ 在 Google Cloud 主控台中為您的 Google Workspace 專案註冊的 OAuth 2.0 用戶端，並啟用 Google Chat API。
+ 如需 Amazon Quick 訂閱需求，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

## 設定 Google Cloud
<a name="google-chat-source-setup"></a>

對於自訂 OAuth 應用程式身分驗證，請在 [Google Cloud 主控台](https://console.cloud.google.com/)中建立 OAuth 2.0 用戶端、為您的專案啟用 Google Chat API、使用您需要的聊天範圍設定 OAuth 同意畫面 （例如，`chat.messages`、`chat.spaces`)，並將 Amazon Quick 回呼 URL 新增`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`為授權的重新導向 URI。將 {{{region}}} 取代為您的AWS區域 （例如 `us-east-1`)。如需step-by-step說明，請參閱 [Google Workspace 開發人員文件中的 Google Chat API](https://developers.google.com/workspace/chat)。記錄用戶端 ID 和用戶端秘密 - 您在設定 Amazon Quick 時需要它們。

## 在 Amazon Quick 中設定連接器
<a name="google-chat-quicksuite-setup"></a>

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 尋找並選擇 **Google Chat**。

1. 輸入連接器**的名稱**。或者，選擇 **\+ 新增描述**以新增描述。

1. 針對**連線類型**，選擇**公有網路**。

1. 針對 **OAuth 組態**，選擇**自訂 OAuth 應用程式**並設定下列欄位：
   + **基本 URL** – Google Chat MCP 基本 URL。
   + **用戶端 ID** – 來自 Google Cloud OAuth 2.0 用戶端的 OAuth 用戶端 ID。
   + **Public OAuth 用戶端** （選用） – 如果您的 Google Cloud OAuth 2.0 用戶端設定為公有用戶端 （無用戶端秘密），請選取此選項。
   + **用戶端秘密** – 來自 Google Cloud OAuth 2.0 用戶端的用戶端秘密。
   + **權杖 URL** – Google OAuth 權杖端點。
   + **授權 URL** – Google OAuth 授權端點。
   + **重新導向 URL** – 預先填入 Amazon Quick 回呼 URL。

1. 選擇**下一步**。

1. Google 登入視窗隨即開啟。檢閱請求的許可，然後選擇**允許**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。選擇**下一步**。

1. 在**發佈**頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

1. 選擇**發布**。

## 可用動作
<a name="google-chat-actions"></a>

設定連接器後，Google Chat 公開的動作即可使用。若要查看連接器目前的一組動作，請前往 Amazon Quick 主控台中連接器的**可用動作**檢視。

## 管理和疑難排解
<a name="google-chat-troubleshooting"></a>

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 驗證問題
<a name="google-chat-troubleshooting-auth"></a>
+ **登入失敗** – 確認您的 Google Workspace 帳戶處於作用中狀態，而且您可以直接登入 Google Chat。確認 Google Cloud OAuth 2.0 用戶端中的授權重新導向 URI 符合 Amazon Quick 回呼 URL。
+ **無效的用戶端登入**資料 – 驗證用戶端 ID 和用戶端秘密是否與 Google Cloud OAuth 2.0 用戶端中的值相符。
+ **許可不足** – 確認聊天 API 已啟用，且 OAuth 同意畫面包含您想要使用的操作所需的範圍。