このページでは、Looker の [Explore アクション] の歯車メニューから [コネクテッド シート] クイックリンク オプションを有効にして使用する方法について説明します。[コネクテッド シート] オプションを選択すると、Google スプレッドシートが開き、Google スプレッドシートから Looker Explore への接続が開始されます。選択した Looker Explore のフィールドを使用して、新しく作成した Google スプレッドシート内でレポート、ピボット テーブル、グラフを作成できます。
始める前に
[コネクテッド シート] クイックリンクを使用するには、次のものが必要です。
- このページのコネクテッド シートのクイックリンクを有効にして構成するで説明されているように、管理者がこの機能を有効にして構成した Looker インスタンス
- シートに接続する LookML モデルに対する
explore権限を持つ Looker ユーザー アカウント - Looker アカウントに関連付けられているものと同じメールアドレスの Google アカウント
Explore からコネクテッド シートのクイックリンクを使用する
Looker 管理者がこの機能を有効にしている場合は、Google スプレッドシートとアクセス権のある Explore の間で接続を開始できます。
Google アカウントに関連付けられているメールアドレスで Looker にログインします。
Looker で、データソースとして使用する Explore に移動します。
[Explore アクション] の歯車アイコンをクリックし、[コネクテッド シート] を選択します。
この機能を初めて使用するときは、Google アカウントへのアクセスを Looker に許可するように求められます。使用する Google アカウントを選択します。Google アカウントのメールアドレスは、Looker ユーザー アカウントに関連付けられているメールアドレスと一致している必要があります。
同意画面に表示されるリクエストされた権限を確認し、[許可] をクリックします。
新しいブラウザタブで Google スプレッドシートが開き、Google アカウントを Looker アカウントにリンクするかどうかを確認するダイアログが表示されます。[アカウントをリンク] をクリックします。
これで、Google スプレッドシートが開始元の Looker Explore に接続されました。Google スプレッドシート内で、Explore のフィールドを追加したり、ピボット テーブルを作成したり、グラフを作成したり、数式を適用して Looker Explore のデータを分析したりできます。
コネクテッド シートでクエリを作成する方法の詳細については、Looker 向けコネクテッド シートの使用のドキュメント ページをご覧ください。
コネクテッド シートのクイックリンクを有効にして構成する
[Explore アクション] の歯車メニューで [コネクテッド シート] クイックリンクを有効にするには、Looker インスタンスが次の要件を満たしている必要があります。
- インスタンスが Looker 25.20 以降で実行されている必要があります。
- Looker（Google Cloud コア）インスタンスの場合、[コネクテッド シート] クイックリンクは、パブリック セキュア接続またはハイブリッド接続のネットワーク接続でのみサポートされます。Looker（Google Cloud コア）のプライベート接続（プライベート サービス アクセス）インスタンスはサポートされていません。
- Looker（オリジナル）インスタンスの場合、[コネクテッド シート] クイックリンクは、Looker でホストされているインスタンスでのみサポートされます。セルフホスト型の Looker インスタンスはサポートされていません。
Looker インスタンスの [Explore アクション] の歯車メニューで [コネクテッド シート] オプションを有効にするには、管理者が次のセクションで説明する一般的なタスクを行う必要があります。
- コンソールで Google Sheets API を有効にします Google Cloud 。
- Google Sheets API が有効になっているのと同じ Google Cloud コンソール プロジェクトで、 Google Cloud コンソールに OAuth クライアントを作成します。
- Looker BI コネクタ ページで [コネクテッド シートのクイックリンクを有効にする] オプションを有効にして構成します。
コンソールで Google Sheets API を有効にする Google Cloud
The [Connected Sheets] quick link uses the Google Sheets API, so this API must be turned on in the same project that you will use to create the OAuth クライアント. Google Sheets API は、IAM roles/serviceusage.serviceUsageAdmin 権限を持つ IAM ユーザーが有効にできます。
Google Sheets API を有効にする手順は次のとおりです。
コンソールのナビゲーション メニューで、[API とサービス] > [ライブラリ] に移動し、Google Sheets API を開きます。 Google Cloud
コンソールの Google Cloud プロジェクト セレクタを開くから、Looker Explore から Google スプレッドシートに接続するために使用するプロジェクトを選択します。コネクテッド シートのクイックリンクの設定手順全体で同じ Google Cloud コンソール プロジェクトを使用する必要があります。これにより、OAuth を構成するのと同じプロジェクトで Google Sheets API が有効になります。
Google Sheets API ページで、API がまだ有効になっていない場合は [有効にする] をクリックします。
OAuth クライアントを作成する
必要なロールを持つ IAM ユーザーが OAuth クライアントを作成する必要があります。
OAuth クライアントは、任意の Google Cloud プロジェクトで設定できます。ただし、この同じプロジェクトで Google Sheets API を有効にする必要があります 。
クライアントとその認証情報を作成する手順は次のとおりです。
コンソールで、コンソールの Google Cloud Google Cloud プロジェクト セレクタを開く を使用して、Google Sheets API を有効にしたのと同じプロジェクトを開きます。
コンソールのメインメニューを使用して、[API とサービス] > [認証情報] に移動します。 Google Cloud
[認証情報] ページで、[認証情報を作成] プルダウン メニューをクリックし、[OAuth クライアント ID] を選択します。
[アプリケーションの種類] プルダウンで、[ウェブ アプリケーション] を選択します。
[名前] フィールドに、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 Sheets API を有効にし Google Cloud 、コンソールで OAuth クライアントを作成したら Google Cloud 、次の手順で Looker インスタンスの [コネクテッド シート] クイックリンクを有効にできます。
- Looker インスタンスで、[管理] パネルの [プラットフォーム] セクションから [BI コネクタ] を選択します。
- [Google スプレッドシート] 切り替えがまだ有効になっていない場合は、有効にします。
- ネストされた切り替え [コネクテッド シートのクイックリンクを有効にする] を有効にします。
- [クライアント ID] フィールドと [クライアント シークレット] フィールドに、 Google Cloud コンソールで OAuth クライアントを作成したときに Google Cloud コンソールからコピーした値を貼り付けます。
- [保存] をクリックします。
これで、[Explore アクション] の歯車メニューの [コネクテッド シート] オプションが Looker インスタンスに設定されました。
パイロット プログラムからの移行
組織が [シートで開く] 機能の以前のパイロット プログラムに参加していた場合、Looker インスタンスは Looker が提供する一元管理された OAuth クライアントを使用していました。この設定は、各 Looker 管理者が Looker インスタンス用に独自の OAuth クライアントを構成する、より安全でスケーラブルな方法に移行しています。既存のパイロット プログラムのお客様は、機能を継続して使用できるように、この新しい構成に移行する必要があります。
新しいバージョンに移行するには、管理者が Google Cloud コンソールで組織独自の OAuth クライアントを設定し、Looker BI コネクタ管理ページで認証情報を構成する必要があります。手順は初回設定と同じです。このページで説明します。
- コンソールで Google Sheets API を有効にする Google Cloud
- Google Sheets API が有効になっているのと同じ Google Cloud コンソール プロジェクトで、 Google Cloud コンソールに OAuth クライアントを作成する
- Looker BI コネクタ ページで [コネクテッド シートのクイックリンクを有効にする] オプションを有効にして構成する
管理者がこれらの手順を完了すると、インスタンスは新しい顧客管理の OAuth フローを自動的に使用します。以前の試験運用機能と、Looker 管理の OAuth クライアントへの依存関係は無効になります。
トラブルシューティング
- メールアドレスの不一致エラー: Google 認証の手順でエラーが発生した場合は、選択している Google アカウントのメールアドレスが Looker ユーザー アカウントのメールアドレスと完全に一致していることを確認してください。
- ["Connected Sheets"] オプションが表示されない: このオプションは、Looker 管理者が BI コネクタの設定でこの機能を有効にしている場合にのみ、[Explore アクション] の歯車メニューに表示されます。サポートが必要な場合は、Looker 管理者にお問い合わせください。
- Google Cloud コンソールの権 2 限: OAuth クライアントと同意画面を構成する管理者は、 プロジェクトで
roles/oauthconfig.editor権限とroles/serviceusage.serviceUsageAdmin権限を持っている必要があります。 Google Cloud - 公開プレビュー期間中にその他の問題やフィードバックがある場合は、
looker-connected-sheets-external@google.com までメールでお問い合わせください。