本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 谷歌聊天集成
<a name="google-chat-integration"></a>

借助 Google Chat 操作连接器，您可以直接在 Amazon Quick 中使用自然语言从 Google Workspace 账户发送消息、管理空间以及与聊天话题互动。

Google 聊天使用自定义 OAuth 应用程序身份验证。有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="google-chat-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个活跃的 Google Workspace 账户，可以访问你想使用的 Google 聊天空间。
+ 在谷歌云控制台中为你的 Google Workspace 项目注册的 OAuth 2.0 客户端，启用了 Google Chat API。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置谷歌云
<a name="google-chat-source-setup"></a>

要进行自定义 OAuth 应用程序身份验证，请在[谷歌云控制台](https://console.cloud.google.com/)中创建 OAuth 2.0 客户端，为您的项目启用 Google Chat API，使用所需的聊天范围配置 OAuth 同意屏幕（例如，），然后将 Amazon Quick 回调网址添加为授权的重定向 UR `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` I。`chat.messages` `chat.spaces`{{{region}}}替换为您AWS所在的地区（例如，`us-east-1`）。有关分步说明，请参阅 [Google Workspace 开发者文档中的谷歌聊天 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 聊天**。

1. 输入连接器的**名称**。（可选）选择 **\+ 添加描述**以添加描述。

1. 在 “**连接类型**” 中，选择 “**公共网络**”。

1. 对于 **OAuth 配置**，选择**自定义 OAuth 应用程序**并配置以下字段：
   + **基本网址**-谷歌聊天 MCP 基本网址。
   + **客户端 ID** — 来自谷歌云 OAuth 2.0 客户端的 OAuth 客户端 ID。
   + **公共 OAuth 客户端**（可选）— 如果您的 Google Cloud OAuth 2.0 客户端配置为公共客户端（无客户端密钥），请选择此选项。
   + **客户端密钥**-来自谷歌云端 OAuth 2.0 客户端的客户端密钥。
   + **令牌网址**-谷歌 OAuth 令牌端点。
   + **授权网址**-谷歌 OAuth 授权端点。
   + **重定向 URL** — Pre-filled 使用 Amazon 快速回传网址。

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>
+ **Sign-in 失败** — 验证您的 Google Workspace 帐户是否处于活动状态，并且您可以直接登录 Google Chat。确认您的 Google Cloud OAuth 2.0 客户端中授权的重定向 URI 与 Amazon Quick 回传网址相匹配。
+ **无效的客户端凭据**-验证客户端 ID 和客户端密钥是否与 Google Cloud OAuth 2.0 客户端中的值相匹配。
+ **权限不足**-确认已启用 Chat API，以及您的 OAuth 同意屏幕是否包含您要使用的操作所需的范围。