除了公開嵌入外,您也可以私人嵌入 Look、探索和資訊主頁。使用私人嵌入功能時,您可以要求使用者使用 Looker 登入資訊、Google OAuth 或 OpenID Connect 進行驗證。如果使用者未通過驗證,您可以選擇顯示錯誤訊息或顯示登入畫面。
已登入並存取私人嵌入內容的使用者,會受到「工作階段」管理面板中設定的影響,這些設定會決定使用者可保持登入多久、是否可透過多個瀏覽器登入,以及是否會在一段時間未活動後登出。
如果您需要更進階或可自訂的嵌入解決方案,請參閱已簽署嵌入說明文件頁面。
產生嵌入網址
如要為資訊主頁、Look 或 Explore 圖表產生及複製私人嵌入網址,請從資訊主頁的三點選單,或從 Explore 或 Look 的 Explore 動作齒輪選單中,選取「取得嵌入網址」。
「私人嵌入」畫面包含下列元素:
- 「Content URL」欄位會顯示完整的私人嵌入網址。
- 如果您要產生資訊主頁或「探索」嵌入網址,且您的執行個體已啟用自訂主題,您可以使用「套用主題至資訊主頁網址」欄位,選取要加入嵌入網址的主題。當使用者查看嵌入的資訊主頁或「探索」時,系統就會套用主題。
- 透過「在網址中加入目前的參數」切換鈕,您可以選擇是否要將目前的參數 (例如篩選器值) 套用至嵌入網址。如果啟用,系統會在觀看嵌入內容時套用這些參數。
- 選取「複製連結」按鈕,將完整的嵌入網址複製到剪貼簿。
產生並複製嵌入網址後,您可以將網址貼到新的瀏覽器視窗或分頁中,預覽嵌入的內容。您也可以使用這個網址將內容嵌入 iframe。
預覽嵌入的內容
在瀏覽器中貼上嵌入網址,即可預覽嵌入內容的行為和外觀。
查看 iframe 中的嵌入內容
將嵌入網址放入 iframe。例如:
<iframe
src="https://instance_name.cloud.looker.com/embed/dashboards/1"
width="1000"
height="2000"
frameborder="0">
</iframe>
然後視需要嵌入 iframe。
變更嵌入式資訊主頁的外觀
查看網址中含有 /embed
的資訊主頁,即可瞭解嵌入資訊主頁時的顯示方式。
根據預設,系統會使用 Looker 執行個體的預設主題顯示嵌入式資訊主頁。您可以透過多種方式變更嵌入式資訊主頁的外觀,具體取決於您使用的資訊主頁類型:
- 對於任何類型的資訊主頁,您都可以在嵌入網址中指定不同的主題名稱,藉此變更用於顯示資訊主頁的主題。
- 無論是哪種類型的資訊主頁,您都可以使用
_theme
網址引數變更個別資訊主頁主題元素。 - 對於 LookML 資訊主頁,您也可以透過
embed_style
參數修改嵌入的資訊主頁外觀。
使用 theme
網址引數、編輯嵌入設定選項或 embed_style
參數時,系統只會針對引數、選項或參數套用的資訊主頁進行變更。如要自訂多個嵌入式資訊主頁的外觀,請改用主題。
部分顯示設定會覆寫其他設定。詳情請參閱「為嵌入式資訊主頁和探索項目建立及套用主題」說明文件。
為私人嵌入功能啟用登入畫面
如要向尚未登入的使用者顯示登入畫面,您可以將參數 allow_login_screen=true
加入嵌入網址。例如:
<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
^^^^^^^^^^^^^^^^^^^^^^^
如果未新增這個參數,系統會向未登入的使用者顯示 401 錯誤。