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

このページでは、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 を使用するため、OAuth クライアントの作成に使用するプロジェクトでこの API を有効にする必要があります。Google Sheets 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 とクライアント シークレットが表示されます。これらの値をコピーしてメモします。これらの値は、コネクテッド シートのクイックリンク オプションを有効にするときに必要になります。

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

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

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

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

パイロット プログラムからの移行

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

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

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

トラブルシューティング

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