除了公开嵌入之外,您还可以不公开嵌入 Looks、探索和信息中心,因此需要使用 Looker 登录、Google OAuth 或 OpenID Connect 进行身份验证。如果用户未通过身份验证,您可以选择显示错误消息或显示登录屏幕。
登录和访问私密嵌入内容的用户需要遵守会话管理面板中的设置,该设置决定了用户可在多长时间内保持登录状态、能否通过多个浏览器登录,以及用户会在一段时间不活动后退出登录。
如果您需要更高级或可自定义的嵌入式解决方案,请查看我们的单点登录 (SSO) 嵌入文档页面。
嵌入的内容始终反映内容的正式版本。在开发模式下所做的更改会对相关内容产生影响,但这些更改尚未部署到生产环境中。
嵌入样式
按照以下步骤嵌入 Look 的可视化内容:
- 打开已保存的样式。
- 复制网址。
将网址中的
/looks/
更改为/embed/looks/
。例如,https://instance_name.looker.com/looks/4
更改为:
https://instance_name.looker.com/embed/looks/4
将新网址放入 iframe 中。例如:
<iframe src="https://instance_name.looker.com/embed/looks/4" width="600" height="300" frameborder="0"> </iframe>
根据需要嵌入 iframe。
嵌入“探索”专区
按照以下步骤嵌入“探索”的图表:
- 从已保存的外观中选择从此处探索,或转到探索页面并创建所需的可视化图表。
- 复制“探索”页面中的网址。或者,如果您要修改或添加网址参数,请从右上方的齿轮菜单中选择共享,然后复制展开后的网址。
将网址中的
/explore/
更改为/embed/explore/
。例如,https://instance_name.looker.com/explore/my_model/my_explore?...
更改为:
https://instance_name.looker.com/embed/explore/my_model/my_explore?...
将新网址放入 iframe 中。例如:
<iframe src="https://instance_name.looker.com/embed/explore/my_model/my_explore?..." width="1000" height="1000" frameborder="0"> </iframe>
根据需要嵌入 iframe。
嵌入信息中心
按照以下步骤嵌入信息中心:
- 打开已保存的信息中心。
- 复制网址。
对于使用新版信息中心的信息中心,请将网址中的
/dashboards/
更改为/embed/dashboards/
。对于旧版信息中心,请在网址中将/dashboards-legacy/
更改为/embed/dashboards-legacy/
。例如,https://instance_name.looker.com/dashboards/1
更改为:
https://instance_name.looker.com/embed/dashboards/1
将新网址放入 iframe 中。例如:
<iframe src="https://instance_name.looker.com/embed/dashboards/1" width="1000" height="2000" frameborder="0"> </iframe>
根据需要嵌入 iframe。
更改信息中心的嵌入式外观
通过在网址中查看包含 /embed
的信息中心,可了解信息中心嵌入后的显示效果。对于旧版信息中心,您还可以从信息中心的齿轮菜单中选择预览信息中心,以查看信息中心被嵌入后的显示效果。
默认情况下,系统会使用 Looker 实例的默认主题背景显示嵌入式信息中心。您可以通过多种方式更改嵌入式信息中心的外观,具体取决于您使用的信息中心类型:
- 对于任何类型的信息中心,您都可以在嵌入网址中指定其他主题名称,以便更改用于显示信息中心的主题。
- 对于任何类型的信息中心,您都可以使用
_theme
网址参数更改各个信息中心主题元素。 - 对于旧版信息中心,您还可以使用信息中心齿轮菜单中的修改嵌入设置选项来修改信息中心的嵌入外观。
- 对于 LookML 信息中心,您还可以通过
embed_style
参数修改信息中心的嵌入式外观。
使用 theme
网址参数、修改嵌入设置选项或 embed_style
参数仅会更改将参数、选项或参数应用到信息中心的信息中心。如果您想自定义多个嵌入式信息中心的外观,请改用主题背景。
有些显示设置会覆盖其他显示设置。如需了解详情,请参阅为嵌入式信息中心和探索创建和应用主题文档页面。
旧版信息中心嵌入设置
旧版信息中心的嵌入设置将被信息中心的嵌入网址中指定的任何非默认主题或网址中指定的各个主题元素覆盖。
要配置旧版信息中心在嵌入时的显示方式,请执行以下操作:
- 点击信息中心的齿轮菜单,然后选择修改嵌入设置。此操作会打开嵌入设置窗格:
- 选择显示或隐藏信息中心的标题或过滤条件。
- 点击颜色框,调整数字面板元素的颜色。
- 或者,您可以点击撤消更改以返回上次保存的信息中心嵌入设置,也可以点击重置为默认设置将所有设置改回 Looker 实例上所有嵌入式信息中心使用的默认设置。
- 点击保存即可保存更改,点击取消可关闭窗口而不保存更改。
移除旧版信息中心的嵌入设置
如果您要移除旧版信息中心的特殊嵌入设置,请执行以下操作:
- 点击信息中心的齿轮菜单,然后选择修改嵌入设置,打开嵌入设置窗格。
- 点击重置为默认值。
- 点击保存。
为私有嵌入启用登录屏幕
如果要向尚未登录的用户显示登录屏幕,您可以在嵌入网址中添加参数 allow_login_screen=true
。例如:
<iframe src="https://instance_name.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
^^^^^^^^^^^^^^^^^^^^^^^
如果您不添加此参数,系统将向尚未登录的用户显示 401 错误。
对 Looker 登录页面使用同源保护可能会导致您无法为私有嵌入启用登录屏幕。