Looker の Action API を使用すると、デベロッパーはアクション、または Looker がクエリ結果、ダッシュボードの結果、またはユーザー インタラクションを送信できるカスタムの宛先を定義できます。
アクションを開発してウェブサービスとしてデプロイし、Looker インスタンスに追加すると、Looker ユーザーは Looker 内からそのアクションを使用してデータを送信できます。
アクションの使用
Action API は、ユースケースのさまざまなバリエーションをサポートしています。
- アクションは、さまざまなレベルのユーザー操作をサポートします。ユーザーがダッシュボードを表示している間に、アドホックなユーザー インタラクションを促すように設計することも、繰り返しやトリガーされたスケジュールで動作するように設計することもできます。
- アクションでは、データの処理をパラメータ化するために、ユーザーからフォームデータを収集するように Looker に指示できます。
- アクションは、OAuth を使用してサードパーティ サービスに対してユーザー認証をリクエストすることもできます。たとえば、ユーザー固有の宛先に暗黙的にデータを配信できます。
- アクションでは、CSV や Excel などのデータ指向の形式から、プログラムによるユースケース向けのさまざまな JSON 形式、PNG や PDF などの可視化指向の形式など、さまざまな形式のクエリ結果も取得できます。
ユースケースは多様ですが、Looker ユーザーが Looker に指示を出してアクションにデータを送信できるという共通点があります。
そのため、アクションを実装するには、これらのリクエストをリッスンするウェブサービスをデプロイする必要があります。
これを行うには、既存のアプリケーション サーバーにいくつかの新しいエンドポイントを追加するか、この目的専用のウェブサーバーをデプロイするか、Google Cloud Run functions などのサーバーレス環境を使用します。Action API では、リクエスト間で状態を維持する必要がないため、アクション サーバーは、スケーラブルで柔軟なステートレス デプロイ構成を利用できます。
最後に、Action API は JSON 形式の HTTP POST リクエストで構成されているため、任意のサーバー側言語を簡単に使用してアクションを実装できます。Looker は、ActionHub のオープンソース コードなど、TypeScript でいくつかの例を提供しています。
統合サービスのリスト
次のリストは、Looker Action Hub で使用できるサービスを示しています。
このリストを使用する方法は次のとおりです。
- [README ファイルへのリンク] 列に表示される URL は、Looker と連携する統合サービスを有効にして構成する手順を示しています。
- [この統合の使用方法] 列に表示されている URL は、Looker から統合サービスにデータを送信する方法を示しています。一部の記事には有効化の手順も記載されています。
- [必須 LookML タグ] には、コンテンツの基盤となるモデルの
tagsパラメータで使用する必要があるすべての必須タグが一覧表示されます。 - [アクション タイプ] は、統合サービスが送信するデータのレベル（フィールド、クエリ、ダッシュボード）を示します。フィールド レベルのアクションでは、データテーブル内の指定された 1 つのセルの値が送信されます。クエリレベルのアクションでは、Explore または Look のすべての行など、クエリ全体の結果が送信されます。ダッシュボード レベルのアクションでは、ダッシュボードの画像が送信されます。
- [スケジュール設定された配信で利用可能なコンテンツ] は、この統合サービスがアドホックまたはスケジュール設定されたコンテンツ配信として送信できる Looker コンテンツの種類を示します。
- [Google OAuth 認証を使用する] は、統合サービスが認証に Google OAuth 認証情報を使用するかどうかを示します。セルフホスト型 Looker インスタンスが、Google OAuth を使用する Looker Action Hub の要件を満たしていない可能性があります。この潜在的な問題に対する推奨される解決策については、アクションハブを介したデータの共有ドキュメント ページをご覧ください。
- [データ ストリーミングを使用する] は、統合サービスがストリーミング クエリ結果をサポートするかどうかを示します。セルフホスト型 Looker インスタンスが、結果をストリーミングする Looker Action Hub からのアクションを有効にできない可能性があります。この潜在的な問題に対する推奨される解決策については、アクションハブを介したデータの共有ドキュメント ページをご覧ください。
- サポートされている最小の Looker バージョンは、この統合を使用するためにインスタンスで使用される必要がある最も古い Looker バージョンです。
| 統合サービス | 説明 | README ファイルへのリンク | この統合の使用方法 | 必須 LookML タグ | 操作の種類 | スケジュール設定された配信に使用できるコンテンツ | Google OAuth 認証を使用する（はい/いいえ） | データ ストリーミングを使用する（はい/いいえ） | サポートされている最小の Looker バージョン |
|---|---|---|---|---|---|---|---|---|---|
| Airtable | Airtable のテーブルにレコードを追加する。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | Look、Explore | × | × | 5.6 |
| Amazon SageMaker Infer | Amazon SageMaker を使用して推論を実行します。 | README を利用できない | 記事なし | なし | クエリ | Look、Explore | × | ○ | 5.6 |
| Amazon SageMaker Train: 線形学習者 | 線形学習者アルゴリズムを使用して、Amazon SageMaker でトレーニング ジョブを開始します。 | README を利用できない | 記事なし | なし | クエリ | Look、Explore | × | ○ | 5.6 |
| Amazon SageMaker Train: Xgboost | Xgboost アルゴリズムを使用して、Amazon SageMaker でトレーニング ジョブを開始します。 | README を利用できない | 記事なし | なし | クエリ | Look、Explore | × | ○ | 5.6 |
| Amazon Web Services EC2 インスタンスの停止 | Amazon EC2 API を使用して EC2 インスタンスを停止します。 | GitHub の README を読む | コミュニティの記事を表示する | aws_resource_id | フィールド、クエリ | Look、Explore | × | × | 5.6 |
| Auger | クエリ結果を使用して予測モデルを構築します。 | GitHub の README を読む | README を参照 | なし | クエリ | Look、Explore | × | ○ | 5.24 |
| Azure ストレージ | Azure ストレージでデータファイルを送信して保存します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | ○（クエリの場合）、×（ダッシュボードの場合） | 5.6 |
| Braze | Braze のアクションにより、Look から REST API エンドポイントを使用して Braze 内のユーザーにフラグを設定できます。結果に braze_id フィールドがタグ付けされていることを確認します。最大エクスポート数: 10000。 |
GitHub の README を読む | README を参照 | braze_id | クエリ | Look、Explore | × | ○ | 5.6 |
| DataRobot | データを DataRobot に送信し、新しいプロジェクトを作成します。 | GitHub の README を読む | README を参照 | なし | クエリ | Look、Explore | × | ○ | 5.24 |
| DigitalOcean — Droplet を停止する | DigitalOcean API を使用して DigitalOcean プロセスを停止します。 | GitHub の README を読む | コミュニティの記事を表示する | digitalocean_droplet_id | フィールド、クエリ | Look、Explore | × | × | 5.6 |
| DigitalOcean スペース | DigitalOcean ストレージにデータファイルを送信して保存します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | ○（Look と Explore の場合）、×（ダッシュボードの場合） | 5.6 |
| Dropbox | Dropbox でデータファイルを送信して保存します。 | README を利用できない | ドキュメントを見る | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | ○ | × | 6.8 |
| Facebook Custom Audiences | 顧客リストから Facebook Ads Custom Audiences にデータをアップロードします。 | GitHub の README を読む | README を参照 | なし | クエリ | Look、Explore | ○ | ○ | 6.10 |
| Firebase | Firebase を使用してモバイルにプッシュ通知を送信します。 | README を利用できない | 記事なし | なし | クエリ | Look、Explore | × | × | 22.4 |
| Google広告カスタマーマッチ | Google 広告のカスタマー マッチにデータをアップロードします。 | GitHub の README を読む | ドキュメントを見る | なし | クエリ | Look、Explore | ○ | ○ | 6.10 |
| Googleアナリティクスデータインポート | Google アナリティクスのデータセットにデータをアップロードします。 | GitHub の README を読む | README を参照 | なし | クエリ | Look、Explore | ○ | ○ | 6.10 |
| Google Cloud Storage | Google Cloud Storage バケットにデータファイルを書き込みます。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | ○（Look と Explore の場合）、×（ダッシュボードの場合） | 5.6 |
| Google ドライブ | Google ドライブにデータを送信します。 | README を利用できない | ドキュメントを見る | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | ○ | ○（Look と Explore の場合）、×（ダッシュボードの場合） | 7.4 |
| Google スプレッドシート | Google スプレッドシートに CSV データを送信します。 | README を利用できない | ドキュメントを見る | なし | クエリ | Look、Explore | ○ | ○ | 7.4 |
| Hubspot の会社 | Hubspot V3 API を使用して、会社にプロパティを追加します。 | GitHub の README を読む | README を参照 | hubspot_company_id | クエリ | Look、Explore | × | ○ | 5.6 |
| Hubspot の連絡先 | Hubspot V3 API を使用して、連絡先にプロパティを追加します。 | GitHub の README を読む | README を参照 | hubspot_contact_id | クエリ | Look、Explore | × | ○ | 5.6 |
| Kloudio | Google スプレッドシートにデータを追加します。 | GitHub の README を読む | README を参照 | なし | クエリ | Look、Explore | × | × | 5.6 |
| mParticle | ユーザーまたはイベントデータを Looker から mParticle に一括エクスポートします。 | GitHub の README を読む | README を参照 | README を参照 | クエリ | Look、Explore | × | ○ | 5.6 |
| Salesforce キャンペーン | Salesforce キャンペーンに連絡先やリードを追加します。 | GitHub の README を読む | README を参照 | sfdc_contact_id または sfdc_lead_id | クエリ | Look、Explore | ○ | × | 22.6 |
| セグメント グループ | セグメント グループに特性やユーザーを追加します。 | GitHub の README を読む | ドキュメントを見る | segment_group_id および user_id、または segment_group_id および segment_anonymous_id | クエリ | Look、Explore | × | ○ | 4.20 |
| セグメント ID | ID を使用してセグメント ユーザーに特性を追加します。 | GitHub の README を読む | ドキュメントを見る | メールアドレスまたは user_id または segment_anonymous_id または segment_group_id | クエリ | Look、Explore | × | ○ | 4.20 |
| セグメント トラック | セグメントが提供するいくつかの統合に接続して、マーケティング ワークフローのユーザーを識別してターゲットにします。 | GitHub の README を読む | ドキュメントを見る | メールアドレスまたは user_id または segment_anonymous_id または segment_group_id | クエリ | Look、Explore | × | ○ | 4.20 |
| SendGrid | データを送信し、SendGrid の API を使用してメールアドレスに送信する結果をスケジュールします。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | × | 5.6 |
| Slack | OAuth を使用して、Looker コンテンツを Slack のダイレクト メッセージ、パブリック チャンネル、プライベート チャンネルで送信できます。これが利用できるのは、Looker 6.24 以降の Looker ホスト型のデプロイで、IP 許可リスト機能が無効である場合です。 | README を利用できない | ドキュメントを見る | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | ○ | ○（Look と Explore の場合）、×（ダッシュボードの場合） | 6.24 |
| Slack アタッチメント（API トークン） | ユーザーの認証情報とともにデータを Slack チャンネルに直接送信します。Slack の追加機能については、Lookerbot ドキュメントを参照することもできます。 | GitHub の README を読む | ドキュメントを見る | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | × | 5.6 |
| Teams - 受信 Webhook | 受信 Webhook を使用して Microsoft Teams にデータを送信します。 | GitHub の README を読む | README を参照 | なし | クエリ、ダッシュボード | Look、Explore、ダッシュボード | × | × | 5.6 |
| Tray | Tray.io が提供するさまざまな統合に接続して、ワークフローを自動化します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | Look、Explore | × | ○ | 5.6 |
| Twilio — データを送信する | Twilio の API を使用して Look からデータを送信するか、結果のスケジュールを設定して電話番号に送信します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | Look、Explore | × | × | 5.6 |
| Twilio — メッセージを送信する | Look で、一連の電話番号（電話番号としてタグ付けされたデータ列）にメッセージを送信します。 | GitHub の README を読む | README を参照 | 電話 | フィールド、クエリ | Look、Explore | × | × | 5.6 |
| Zapier | Zapier が提供するさまざまな統合に接続して、ワークフローを自動化します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | Look、Explore | × | ○ | 5.6 |
詳細情報
詳細については、アクション ハブを介したデータの共有のドキュメント ページをご覧ください。