本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
谷歌分析集成
使用 Google Analytics 操作连接器，您可以直接在 Amazon Quick 中通过自然语言访问谷歌分析。您无需离开 Amazon Quick 即可运行报告、检索受众数据、监控关键事件和访问实时指标。
Amazon Quick 支持谷歌分析的多种身份验证方法。选择最适合贵组织安全要求的方法。
-
默认 OAuth 应用程序-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。您可以直接使用自己的 Google 帐号进行身份验证。
-
自定义 OAuth 应用程序-使用在谷歌云控制台中创建的客户托管 OAuth 客户端。此选项可让您的组织完全控制 OAuth 配置。
有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。
开始前的准备工作
在设置集成之前，请确保您具备以下条件。
配置谷歌云
如果您使用默认 OAuth 应用程序身份验证，请跳过此部分并转至。在 Amazon Quick 中设置连接器
要进行自定义 OAuth 应用程序身份验证，请在配置 Amazon Quick 之前在谷歌云控制台中完成以下步骤。在步骤 3 中启用 API 时，请搜索并启用谷歌分析数据 API。
在谷歌云控制台中创建 OAuth 客户端
在谷歌云控制台中创建 OAuth 客户端，以获取 Amazon Quick 所需的客户端凭证。有关更多信息，请参阅谷歌网站上的使用 OAuth 2.0 访问谷歌 API
-
在谷歌网站上登录谷歌云端控制台
。 -
创建新项目或选择现有项目。
-
在左侧导航窗格中，选择 API 和服务，然后选择库。搜索您的集成所需的 API，然后选择启用。
-
选择 OAuth 同意屏幕，然后选择开始。
-
配置同意屏幕：
-
输入应用程序名称并选择用户支持电子邮件。
-
对于受众，请选择内部（仅限您的组织）或外部（任何 Google 用户）。
-
添加开发者联系方式并选择创建。
-
-
选择创建 OAuth 客户端。
-
配置客户端：
-
对于应用程序类型，选择 Web 应用程序。
-
为您的客户输入一个姓名。
-
在 “授权重定向 URI” 下，添加 Amazon Quick 回传 URL：
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
选择创建。
-
记录以下值。您在配置 Amazon Quick 时需要它们。
-
客户端 ID
-
客户端密钥
-
推荐瞄准镜
当您连接到谷歌分析时，需要以下范围。
| Scope | 说明 |
|---|---|
https://www.googleapis.com/auth/analytics.readonly |
读取分析数据和配置。 |
https://www.googleapis.com/auth/analytics.edit |
编辑分析配置和数据。 |
openid |
验证用户的身份。 |
email |
读取用户的电子邮件地址。 |
注意
openid和email范围会自动包含在 OAuth 用户身份验证的同意流程中。它们不是 Service-to-Service OAuth 所必需的。
在 Amazon Quick 中设置连接器
从 “可用” 选项卡连接
如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “可用” 选项卡进行连接。
-
在 Amazon Quick 控制台中，选择连接器。
-
在 “可用” 选项卡上，找到谷歌分析，然后选择 Connect。
-
完成 Google 登录流程并授予所请求的权限。
要改为使用自定义 OAuth 应用程序配置连接器，请使用为团队创建选项卡，如下所述。
从 “为你的团队创建” 选项卡创建
完成所有必需的 Google Cloud 配置后，请在 Amazon Quick 中创建连接器。
-
在 Amazon Quick 控制台中，选择连接器。
-
选择 “为你的团队创建” 选项卡。
-
找到并选择谷歌分析。
注意
如果 Google Analytics（分析）连接器已经存在，则会出现一个包含您现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “否，新建”。
-
输入连接器的名称。（可选）选择 + 添加描述以添加描述。
-
对于连接类型，选择公共网络。
-
对于 OAuth 配置，请选择以下身份验证方法之一并配置必填字段。
-
对于默认 OAuth 应用程序：
无需其他凭证。选择下一步以继续。
-
对于自定义 OAuth 应用程序，请配置以下字段：
-
基本网址（可选）-谷歌分析 API 基本网址。示例：
https://analyticsdata.googleapis.com -
客户端 ID — 来自谷歌云端 OAuth 客户端的客户端 ID。
-
客户密钥-来自谷歌云端 OAuth 客户端的客户端密钥。
-
令牌网址-令牌端点。示例：
https://oauth2.googleapis.com/token -
授权 URL-授权端点。示例：
https://accounts.google.com/o/oauth2/v2/auth -
重定向 URL — Pre-filled 使用 Amazon 快速回传网址。
-
-
-
选择下一步。
-
如果您选择默认 OAuth 应用程序或自定义 OAuth 应用程序，则会打开 Google 授权窗口。查看请求的权限并选择 “允许”。
-
在 “查看” 页面上，查看连接器的可用操作。选择下一步。
-
在 “发布” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。
-
选择发布。
可用操作
设置连接器后，可以使用以下操作。
| 类别 | 处理建议 | 说明 |
|---|---|---|
| Reports | 创建报告 | 为属性运行报告。 |
| Reports | Batch 创建报告 | 在单个请求中运行多个报告。 |
| Reports | 创建实时报告 | 为房产运行实时报告。 |
| Reports | 创建漏斗报告 | 为属性运行漏斗报告。 |
| 受众 | 列出受众 | 列出房产的受众群体。 |
| 受众 | 创建受众名单 | 创建要导出的受众列表。 |
| 受众 | 列出受众名单 | 列出房产的受众名单。 |
| 受众 | 获取观众名单 | 从受众群体列表中检索数据。 |
| 受众 | 创建受众导出 | 创建受众导出。 |
| 受众 | 获取受众导出 | 从受众导出中检索数据。 |
| 账户 | 列出账户摘要 | 列出用户可以访问的账户摘要。 |
| 账户 | 列出账户 | 列出用户可以访问的所有帐户。 |
| 账户 | 获取账号 | 检索特定账户的详细信息。 |
| Properties | 获取房产 | 检索特定属性的详细信息。 |
| Properties | 搜索房产 | 使用筛选功能搜索房产。 |
| Properties | 获取房产配额 | 检索属性的配额使用情况。 |
| Events | 列出关键事件 | 列出属性的关键事件（转化）。 |
| 元数据 | 获取元数据 | 检索用于报告的可用维度和指标。 |
| 元数据 | 获取兼容性 | 检查报告的维度和指标的兼容性。 |
| Annotations | 列出注释 | 列出属性的报告数据注释。 |
注意
您可以使用的操作取决于经过身份验证的用户可以访问的 Analytics 属性和帐户。
管理和故障排除
要编辑、共享或删除您的连接器，请参阅管理现有集成。
常见的谷歌身份验证问题
-
Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）— 确认您的 Google 帐户处于活动状态，并且可以直接登录 Google 网站。
对于自定义 OAuth 应用程序，请确认您的 Google Cloud OAuth 客户端中的重定向 URI 是否与 Amazon Quick 回传网址相匹配。 -
应用程序被管理员屏蔽-如果您的 Google Workspace 管理员限制了第三方应用程序的访问权限，那么您在尝试登录时可能会看到错误消息。请联系您的 Google 工作空间管理员以允许使用 Amazon Quick 应用程序。
-
无效的客户端凭据（自定义 OAuth 应用程序）-验证客户端 ID 和客户端密钥是否与 Google Cloud OAuth 客户端中的值相匹配。
-
身份验证弹出窗口失败 — 确认您的浏览器允许来自 Amazon Quick 控制台域的弹出窗口。尝试使用其他浏览器或清除浏览器缓存。
-
权限已撤销 — 如果您之前从 Google 帐号权限设置中撤消了 Amazon Quick 访问权限，则需要通过编辑连接器并重新登录来重新进行身份验证。
-
Google API 速率限制 — Google 可能会在高使用率期间限制请求。如果操作失败，请在几分钟后重试。
谷歌 Analytics-specific 问题
-
未启用 Google Analytics 数据 AP I — 确认您的谷歌云项目的 “API 和服务”、“资源库” 下的 “谷歌分析数据 API” 已启用。
-
没有可见的属性-验证经过身份验证的 Google 帐号是否有权访问您要查询的 Google Analytics（分析）属性。
