コネクテッド シートのクイックリンク

このページでは、Looker の [Explore アクション] の歯車メニューから [コネクテッド シート] のクイック リンク オプションを有効にして使用する方法について説明します。[コネクテッド シート] オプションを選択すると、Google スプレッドシートが開き、Google スプレッドシートから Looker の Explore への接続が開始されます。その後、選択した Looker Explore のフィールドを使用して、新しく作成した Google スプレッドシート内でレポート、ピボット テーブル、グラフを作成できます。

始める前に

コネクテッド シートのクイック リンクを使用するには、次のものが必要です。

  • このページのコネクテッド シートのクイックリンクを有効にして構成するで説明されているように、管理者がこの機能を有効にして構成した Looker インスタンス
  • シートに接続する LookML モデルに対する explore 権限を持つ Looker ユーザー アカウント
  • Looker アカウントに関連付けられているメールアドレスと同じメールアドレスの Google アカウント

Looker 管理者がこの機能を有効にしている場合、Google スプレッドシートとアクセス権のある Explore の間の接続を開始できます。

  1. Google アカウントに関連付けられているメールアドレスで Looker にログインします。

  2. Looker で、データソースとして使用する Explore に移動します。

  3. [Explore アクション] の歯車アイコンをクリックし、[接続済みのシート] を選択します。

  4. この機能を初めて使用する際は、Looker が Google アカウントにアクセスすることを承認するよう求められます。使用する Google アカウントを選択します。Google アカウントのメールアドレスは、Looker ユーザー アカウントに関連付けられているメールアドレスと一致している必要があります。

  5. 同意画面でリクエストされた権限を確認し、[許可] をクリックします。

  6. 新しいブラウザタブで Google スプレッドシートが開き、Google アカウントを Looker アカウントにリンクするかどうかを尋ねるダイアログが表示されます。[アカウントをリンク] をクリックします。

これで、Google スプレッドシートが、開始した Looker Explore に接続されました。Google スプレッドシート内で、Explore からフィールドを追加したり、ピボット テーブルを作成したり、グラフを作成したり、数式を適用して Looker Explore のデータを分析したりできます。

コネクテッド シートでのクエリの作成について詳しくは、Looker 用コネクテッド シートの使用のドキュメント ページをご覧ください。

コネクテッド シートのクイックリンクを有効にして構成する

[Explore アクション] の歯車メニューで [コネクテッド シート] のクイックリンクを有効にするには、Looker インスタンスが次の要件を満たしている必要があります。

Looker インスタンスの [Explore アクション] 歯車メニューで [コネクテッド シート] オプションを有効にするには、管理者が次のセクションで説明する一般的なタスクを実行する必要があります。

Google Cloud コンソールで Google Sheets API を有効にする

[接続済みのシート] クイック リンクは Google Sheets API を使用するため、この API は OAuth クライアントの作成に使用するのと同じプロジェクトで有効にする必要があります。Google スプレッドシート API は、IAM roles/serviceusage.serviceUsageAdmin 権限を持つ IAM ユーザーが有効にできます。

Google Sheets API を有効にするには、次の手順を行います。

  1. Google Cloud コンソールのナビゲーション メニューで、[API とサービス] > [ライブラリ] に移動し、Google Sheets API を開きます。

    Google Sheets API に移動

  2. Google Cloud コンソールのプロジェクト選択ツールを開き、Looker の Explore から Google スプレッドシートへの接続に使用するプロジェクトを選択します。接続済みのスプレッドシートのクイック リンクの設定手順全体で同じ Google Cloud コンソール プロジェクトを使用する必要があります。これにより、OAuth を構成するのと同じプロジェクトで Google Sheets API が有効になります。

  3. [Google Sheets API] ページで、API がまだ有効になっていない場合は、[有効にする] をクリックします。

OAuth クライアントを作成する

必要なロールを持つ IAM ユーザーが OAuth クライアントを作成する必要があります。

OAuth クライアントは、任意の Google Cloud プロジェクトで設定できます。ただし、この同じプロジェクトで Google Sheets API を有効にする必要があります。

クライアントとその認証情報を作成する手順は次のとおりです。

  1. Google Cloud コンソールで、 Google Cloud コンソールのプロジェクト選択ツールを開くを使用して、Google Sheets API を有効にしたのと同じプロジェクトを開きます。

    Google Cloud コンソールに移動

  2. Google Cloud コンソールのメイン メニューで、[API とサービス] > [認証情報] に移動します。

  3. [認証情報] ページで、[認証情報を作成] プルダウン メニューをクリックし、[OAuth クライアント ID] を選択します。

  4. [アプリケーションの種類] プルダウンで、[ウェブ アプリケーション] を選択します。

  5. [名前] フィールドに、OAuth クライアントの名前（Looker to Connected Sheets など）を入力します。

  6. [承認済みのリダイレクト URI] セクションで、[URI を追加] ボタンをクリックします。次の URI を追加します。

    https://LOOKER_INSTANCE_URL/oauth2callback

  7. [URI を追加] ボタンをクリックして、次の URI も追加します。

    https://LOOKER_INSTANCE_URL/external_oauth/redirect

  8. [作成] をクリックします。

  9. [作成] をクリックすると、[OAuth クライアントを作成しました] ウィンドウが表示されます。このウィンドウには、 Google Cloud コンソールが OAuth クライアント用に作成したクライアント ID とクライアント シークレットが表示されます。これらの値は、[Enable Connected Sheets quick link] オプションを構成するときに必要になるため、コピーしてメモしておきます。

[コネクテッド シートのクイックリンクを有効にする] オプションの設定

Google Cloud コンソールで Google Sheets API を有効にし、 Google Cloud コンソールで OAuth クライアントを作成したら、次の手順で Looker インスタンスの [Connected Sheets] クイック リンクを有効にできます。

  1. Looker インスタンスで、[管理者] パネルの [プラットフォーム] セクションから [BI コネクタ] を選択します。
  2. [Google スプレッドシート] の切り替えが有効になっていない場合は、有効にします。
  3. ネストされた切り替え [コネクテッド シートのクイックリンクを有効にする] を有効にします。
  4. [クライアント ID] フィールドと [クライアント シークレット] フィールドに、 Google Cloud コンソールで OAuth クライアントを作成したときに Google Cloud コンソールからコピーした値を貼り付けます。
  5. [保存] をクリックします。

これで、Looker インスタンスの [Explore アクション] の歯車メニューで [コネクテッド シート] オプションが設定されました。

試験運用プログラムからの移行

組織が以前の [スプレッドシートで開く] 機能のパイロット プログラムに参加していた場合、Looker インスタンスは Looker が提供する一元管理された OAuth クライアントを使用していました。この設定は、各 Looker 管理者が Looker インスタンス用に独自の OAuth クライアントを構成する、より安全でスケーラブルな方法に置き換えられます。既存のパイロット版のお客様は、機能を継続して利用するために、この新しい構成に移行する必要があります。

新しいバージョンに移行するには、管理者が Google Cloud コンソールで組織独自の OAuth クライアントを設定し、Looker BI Connectors の管理ページで認証情報を構成する必要があります。手順は初回設定と同じです。初回設定については、このページの次のセクションで説明しています。

管理者がこれらの手順を完了すると、インスタンスは新しい顧客管理の OAuth フローを自動的に使用します。以前の試験運用機能と、その機能が依存していた Looker 管理の OAuth クライアントは無効になります。

トラブルシューティング

  • メールアドレスの不一致エラー: Google 認証の手順でエラーが発生した場合は、選択した Google アカウントのメールアドレスが Looker ユーザー アカウントのメールアドレスと完全に一致していることを確認してください。
  • [Connected Sheets] オプションが表示されない: このオプションは、Looker 管理者が BI コネクタの設定でこの機能を有効にしている場合にのみ、[データ探索のアクション] 歯車メニューに表示されます。サポートが必要な場合は、Looker 管理者にお問い合わせください。
  • Google Cloud コンソールの権限: OAuth クライアントと同意画面を構成する管理者は、 Google Cloud プロジェクトで roles/oauthconfig.editor 権限と roles/serviceusage.serviceUsageAdmin 権限を持っている必要があります。
  • パブリック プレビュー期間中のその他の問題やフィードバックについては、looker-connected-sheets-external@google.com までメールでお問い合わせください。