本页介绍了如何通过 Looker 中的探索操作齿轮菜单启用和使用关联工作表快捷链接选项。关联工作表选项会打开 Google 表格，并启动从 Google 表格到 Looker 探索的连接。然后，您可以使用所选 Looker 探索中的字段，在新建的 Google 表格中构建报告、数据透视表或图表。
准备工作
如需使用关联工作表快捷链接，您需要满足以下条件：
- 已由管理员启用并配置为支持此功能的 Looker 实例，如本页面的启用和配置“关联工作表”快捷链接部分中所述
- 具有您要连接到 Google 表格的 LookML 模型的
explore权限的 Looker 用户账号 - 与您的 Looker 账号关联的电子邮件地址相同的 Google 账号
通过探索中的“关联工作表”快捷链接使用关联工作表
如果 Looker 管理员已启用该功能，您可以启动 Google 表格与您有权访问的任何探索之间的连接：
使用与您的 Google 账号关联的电子邮件地址登录 Looker。
在 Looker 中，找到要用作数据源的探索。
点击 探索操作齿轮图标，然后选择关联工作表。
首次使用此功能时，系统会提示您授权 Looker 访问您的 Google 账号。选择您要使用的 Google 账号。Google 账号的电子邮件地址必须与您的 Looker 用户账号关联的电子邮件地址一致。
查看意见征求屏幕上请求的权限，然后点击允许。
系统会打开一个新的浏览器标签页，其中显示 Google 表格，并弹出一个对话框，询问您是否要将 Google 账号与 Looker 账号相关联。点击关联账号。
现在，Google 工作表已连接到您开始使用的 Looker 探索。在 Google 工作表中，您可以添加探索中的字段、创建数据透视表、构建图表和应用公式来分析 Looker 探索中的数据。
如需详细了解如何在关联工作表中构建查询，请参阅将关联工作表用于 Looker 文档页面。
启用和配置“关联工作表”快捷链接
如需在探索操作齿轮菜单中启用关联工作表快捷链接，您的 Looker 实例必须满足以下要求：
- 您的实例必须运行 Looker 25.20 或更高版本。
- 对于 Looker (Google Cloud Core) 实例，关联工作表快捷链接仅支持公共安全连接或混合连接网络连接。不支持 Looker (Google Cloud Core) 专用连接（专用服务访问通道）实例。
- 对于 Looker（原始版本）实例，关联工作表快捷链接仅适用于 Looker 托管的实例。不支持客户托管的 Looker 实例。
如需在 Looker 实例的探索操作齿轮菜单中启用关联工作表选项，管理员必须执行以下常规任务（详见下文）：
- 在 Google Cloud 控制台中启用 Google Sheets API。
- 在 Google Cloud 控制台中创建 OAuth 客户端，该控制台项目与启用 Google Sheets API 的 Google Cloud 控制台项目相同。
- 在 Looker BI 连接器页面上启用并配置启用“关联工作表”快捷链接选项。
在 Google Cloud 控制台中启用 Google Sheets API
关联的工作表快捷链接使用 Google Sheets API，因此必须在用于创建 OAuth 客户端的同一项目中启用此 API。拥有 IAM roles/serviceusage.serviceUsageAdmin 权限的 IAM 用户可以启用 Google Sheets API。
请按以下步骤启用 Google Sheets API：
在 Google Cloud 控制台的导航菜单中，依次前往 API 和服务 > 库，然后打开 Google Sheets API。
在 Google Cloud 控制台中，打开项目选择器，然后选择要用于从 Looker 探索中连接到 Google 表格的项目。您必须在整个关联工作表的快捷链接设置过程中使用相同的 Google Cloud 控制台项目，以便在您配置 OAuth 的同一项目中启用 Google Sheets API。
在 Google Sheets API 页面上，如果该 API 尚未启用，请点击启用。
创建 OAuth 客户端
具有所需角色的 IAM 用户必须创建 OAuth 客户端。
您可以在所需的任何 Google Cloud 项目中设置 OAuth 客户端。不过，您必须在同一项目中启用 Google Sheets API。
如需创建客户端及其凭据，请按以下步骤操作：
在 Google Cloud 控制台中，使用 Google Cloud 控制台的打开项目选择器打开您启用 Google Sheets API 的同一项目。
使用 Google Cloud 控制台主菜单导航到 API 和服务 > 凭据。
在凭据页面上，点击创建凭据下拉菜单，然后选择 OAuth 客户端 ID。
在应用类型下拉菜单中，选择 Web 应用。
在名称字段中，输入 OAuth 客户端的名称，例如
Looker to Connected Sheets。在已获授权的重定向 URI 部分中，点击添加 URI 按钮。添加以下 URI：
https://LOOKER_INSTANCE_URL/oauth2callback点击添加 URI 按钮，同时添加以下 URI：
https://LOOKER_INSTANCE_URL/external_oauth/redirect点击创建。
点击创建后，系统会显示 OAuth 客户端已创建窗口。此窗口会显示 Google Cloud 控制台为您的 OAuth 客户端创建的客户端 ID 和客户端密钥。请复制并记下这些值，因为在配置“启用关联的工作表”快捷链接选项时需要用到它们。
配置“启用关联工作表”快捷链接选项
在 Google Cloud 控制台中启用 Google Sheets API 并在 Google Cloud 控制台中创建 OAuth 客户端后，您可以按照以下步骤在 Looker 实例中启用关联的工作表快捷链接：
- 在 Looker 实例中，从管理面板的平台部分选择 BI 连接器。
- 启用 Google 表格切换开关（如果尚未启用）。
- 启用嵌套切换开关启用“关联工作表”快捷链接。
- 在客户端 ID 和客户端密钥字段中，粘贴您在 Google Cloud 控制台中创建 OAuth 客户端 Google Cloud 时从 Google Cloud 控制台中复制的值。
- 点击保存。
探索操作齿轮菜单中的关联工作表选项现已为您的 Looker 实例设置完毕。
从小规模测试计划迁移
如果您的组织之前参与了在 Google 表格中打开功能的早期 Beta 版计划，则您的 Looker 实例使用的是由 Looker 提供的集中式管理的 OAuth 客户端。此设置已被弃用，取而代之的是一种更安全且可伸缩的方法，即每个 Looker 管理员为其 Looker 实例配置自己的 OAuth 客户端。现有试点客户应过渡到此新配置，以确保功能持续可用。
如需迁移到新版本，管理员必须在 Google Cloud 控制台中设置组织的 OAuth 客户端，然后在 Looker BI Connectors 管理员页面中配置凭据。这些步骤与首次设置的步骤相同，具体请参阅本页的以下部分：
- 在 Google Cloud 控制台中启用 Google Sheets API
- 在 Google Cloud 控制台中创建 OAuth 客户端，该客户端位于启用了 Google Sheets API 的同一 Google Cloud 控制台项目中
- 在 Looker BI 连接器页面上启用并配置启用“关联工作表”快捷链接选项
管理员完成这些步骤后，您的实例将自动使用新的客户管理的 OAuth 流程。之前的 Beta 版功能及其对 Looker 管理的 OAuth 客户端的依赖关系将不再有效。
问题排查
- 电子邮件地址不一致错误：如果您在 Google 身份验证步骤中遇到错误，请确保您选择的 Google 账号的电子邮件地址与您的 Looker 用户账号完全相同。
- 未显示“关联的工作表”选项：只有当 Looker 管理员在 BI 连接器设置中启用此功能后，此选项才会显示在探索操作齿轮菜单中。请与您的 Looker 管理员联系，以获取帮助。
- Google Cloud 控制台权限：配置 OAuth 客户端和权限请求页面的管理员需要在 Google Cloud 项目中拥有
roles/oauthconfig.editor和roles/serviceusage.serviceUsageAdmin权限。 - 如果您在公开预览版期间遇到其他问题或有反馈意见，请发送电子邮件至
looker-connected-sheets-external@google.com。