一般公開の埋め込みに加えて、Look、Explore、ダッシュボードを非公開で埋め込むこともできます。そのため、Looker ログイン、Google OAuth、または OpenID Connect を使用する認証が必要です。ユーザーが認証されていない場合は、エラー メッセージを表示するか、ログイン画面を表示するかを選択できます。
非公開で埋め込まれたコンテンツにログインしたユーザーには、[セッション管理] パネルの設定が適用されます。ここでログイン時間の上限、複数のブラウザからのログインが可能かどうか、非アクティブな状態が一定期間続くとログアウトするかどうかが決まります。
より高度な、またはカスタマイズ可能な埋め込みソリューションが必要な場合は、Google のシングル サインオン(SSO)埋め込みドキュメント ページをご覧ください。
埋め込みコンテンツには、常に製品版のコンテンツが反映されています。開発モードで行われた変更のうち、コンテンツに影響を与えていて本番環境にデプロイされていない変更は、埋め込みに表示されません。
Lookを埋め込む
Lookc ビジュアリゼーションを埋め込む手順は次のとおりです。
- 保存されたLookを開きます。
- そのURLをコピーします。
URL の
/looks/
を/embed/looks/
に変更します。次に例を示します。https://instance_name.looker.com/looks/4
上記を以下のように変更します。
https://instance_name.looker.com/embed/looks/4
新しい URL を iframe に配置します。例:
<iframe src="https://instance_name.looker.com/embed/looks/4" width="600" height="300" frameborder="0"> </iframe>
必要に応じてiframeを埋め込みます。
Exploreを埋め込む
Explore を可視化する手順は次のとおりです。
- 保存済みの Look から [Explore from Here] を選択するか、[Explore] ページに移動して、目的のビジュアリゼーションを作成します。
- データ探索ページから URL をコピーします。または、URL パラメータを変更または追加する場合は、右上の歯車メニューから [共有] を選択し、[拡張 URL] をコピーします。
URL の
/explore/
を/embed/explore/
に変更します。次に例を示します。https://instance_name.looker.com/explore/my_model/my_explore?...
上記を以下のように変更します。
https://instance_name.looker.com/embed/explore/my_model/my_explore?...
新しい URL を iframe に配置します。例:
<iframe src="https://instance_name.looker.com/embed/explore/my_model/my_explore?..." width="1000" height="1000" frameborder="0"> </iframe>
必要に応じてiframeを埋め込みます。
ダッシュボードを埋め込む
ダッシュボードを埋め込むには、次の手順を実行します。
- 保存されたダッシュボードを開きます。
- そのURLをコピーします。
新しいダッシュボードを使用するダッシュボードの場合は、URL の
/dashboards/
を/embed/dashboards/
に変更します。以前のダッシュボードの場合は、URL で/dashboards-legacy/
を/embed/dashboards-legacy/
に変更します。次に例を示します。https://instance_name.looker.com/dashboards/1
上記を以下のように変更します。
https://instance_name.looker.com/embed/dashboards/1
新しい URL を iframe に配置します。例:
<iframe src="https://instance_name.looker.com/embed/dashboards/1" width="1000" height="2000" frameborder="0"> </iframe>
必要に応じてiframeを埋め込みます。
ダッシュボードの埋め込みの外観を変更する
URL に /embed
を含むダッシュボードを表示すると、埋め込み時にダッシュボードがどのように表示されるかを確認できます。以前のダッシュボードの場合は、ダッシュボードの歯車メニューから [プレビュー ダッシュボード] を選択して、ダッシュボードを埋め込んだときにダッシュボードがどのように表示されるかを確認することもできます。
デフォルトでは、埋め込みダッシュボードは Looker インスタンスのデフォルトのテーマを使用して表示されます。使用しているダッシュボードの種類に応じて、埋め込みダッシュボードの外観を変更する方法がいくつかあります。
- いずれのタイプのダッシュボードでも、埋め込み URL に別のテーマ名を指定して、ダッシュボードの表示に使用するテーマを変更できます。
- どのタイプのダッシュボードでも、
_theme
URL 引数を使用して、ダッシュボードの個々のテーマ要素を変更できます。 - 以前のダッシュボードの場合は、ダッシュボードの歯車メニューで [埋め込み設定を編集] オプションを使用して、ダッシュボードの埋め込み外観を変更することもできます。
- LookML ダッシュボードの場合は、
embed_style
パラメータを使用してダッシュボードの埋め込み表示を変更することもできます。
theme
URL 引数、埋め込み設定を編集オプション、または embed_style
パラメータを使用すると、ダッシュボードに変更できるのは、引数、オプション、またはパラメータが適用されている場合のみです。複数の埋め込みダッシュボードの外観をカスタマイズする場合は、代わりにテーマを使用します。
ディスプレイ設定の中には、他の設定をオーバーライドするものがあります。詳細については、埋め込みダッシュボードと Explore のテーマの作成と適用のドキュメントをご覧ください。
レガシーダッシュボードの埋め込み設定
以前のダッシュボードの埋め込み設定は、ダッシュボードの埋め込み URL で指定されたデフォルト以外のテーマ、または URL で指定された個別のテーマ要素によりオーバーライドされます。
以前のダッシュボードが埋め込まれている場合の表示方法を設定するには:
- ダッシュボードの歯車メニューをクリックし、[埋め込み設定を編集] を選択します。これにより、埋め込み設定ペインが開きます。
- ダッシュボードのタイトルまたはフィルタの表示と非表示を切り替えます。
- カラーボックスをクリックして、ダッシュボード要素の色を調整します。
- 必要に応じて、[変更を元に戻す] をクリックして、ダッシュボードに最後に保存された埋め込み設定に戻すことも、[デフォルトにリセット] をクリックして、Looker インスタンスのすべての埋め込みダッシュボードで使用されるデフォルト設定に戻すこともできます。
- [保存] をクリックして変更を保存するか、[キャンセル] をクリックして変更を保存せずにウィンドウを閉じます。
レガシーダッシュボードの埋め込み設定を削除する
レガシーダッシュボードの特殊な埋め込み設定を削除するには:
- ダッシュボードの歯車メニューをクリックし、[埋め込み設定を編集] を選択して、埋め込み設定ペインを開きます。
- [Reset to Defaults] をクリックします。
- [保存] をクリックします。
プライベート埋め込み用のログイン画面を有効にする
まだログインしていないユーザーにログイン画面を表示したい場合は、埋め込み URL にパラメータ allow_login_screen=true
を追加します。例:
<iframe src="https://instance_name.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
^^^^^^^^^^^^^^^^^^^^^^^
このパラメーターを追加しない場合、まだログインしていないユーザーには401エラーが表示されます。
Looker のログインページに同じオリジンの保護を使用すると、プライベート埋め込みのログイン画面を有効にできなくなる可能性があります。