Looker API の概要

Looker の API により、便利な JSON 指向の REST API を介して、Looker のほとんどの機能にアクセスできます。これには、さまざまな形式でのクエリの単純な実行から、ユーザー、コンテンツ、スケジュール、インスタンス構成の管理まで、さまざまなエンドポイントが含まれています。

多数のユース ケースの一部として API を使用できます。たとえば、内部の運用ツール、高度にカスタム化された顧客対応組み込み分析、モバイルアプリの統合、専用の Looker 管理ツールなどがあります。

API の使用

API は、HTTPS リクエストを介して直接使用するか、言語ごとの SDK を介して使用できます。

さらに、API にはいくつかの認証モードが用意されており、アーキテクチャの選択に役立つ場合があります。バックエンド サービスは API 認証情報による認証が可能で、サービス アカウントで API を使用することも、エンドユーザーに代わって API リクエストの権限を簡単に借用することもできます。あるいは、フロントエンド クライアントは、OAuth 認証(認証コード PKCE)を活用でき、機密性の高いクライアント シークレットを処理する必要はありません。

API がエンドツーエンドで使用される最も一般的な方法の例を次に示します。

  • バックエンドのみ
    • API 認証情報による認証: コマンドライン スクリプト、管理タスク、サンドボックス環境共通
  • フロントエンドとバックエンド
    • アプリケーション サーバーに単一のサービス アカウントと認証情報を提供し、サービス アカウントを使って API 呼び出しを行う
    • 単一のサービス アカウントと認証情報をアプリケーション サーバーに提供するが、Looker の sudo または login_as_user 機能を使用してエンド ユーザーに代わって呼び出しを行う
    • アプリケーション サーバーで認証し、sudo/login_as_user を使用して、生成されたトークンをユーザーに送り、クロスオリジン リソース シェアリング(CORS)でフロントエンド API 呼び出しを行う
  • フロントエンドのみ
    • OAuth で認証し、CORS でフロントエンド API 呼び出しを行う
    • Looker 拡張機能を使用した暗黙的な認証と呼び出し

試してみる

コードを記述する前に API の動作を確認したい場合は、次のデモが役に立ちます。

  • Atom Fashion は、デモ用のデータドリブン ウェブ アプリです(Google アカウントにログインする必要があります)。
  • API Explorer を使用して、API エンドポイントを調べ、Looker インスタンスに対してサンプル API 呼び出しを行います。