Data Studio カスタムコネクタ：作るべきタイミング、仕組み、費用

Data Studio カスタムコネクタとは？

ソースへのログイン方法、提供するフィールド、リクエストに応じた行の取得方法を Data Studio に教えるコードです。Google の開発者向けドキュメントではコミュニティコネクタと呼ばれており（Looker Studio の時代もこの名前のままでした）、Google の Connector API に沿って Google Apps Script で記述します。

どのコネクタも 4 つの関数を定義する必要があります。getAuthType はユーザーのサインイン方法を Data Studio に伝えます。getConfig はアカウント ID や期間の指定要否などの設定をユーザーに尋ねます。getSchema はディメンションと指標の一覧をデータ型とともに返します。getData はグラフが実際に要求したフィールドの行を返します。デプロイすると、コネクタはネイティブの GA4 や Google Ads コネクタと同じようにデータソースとして表示され、レポート、計算フィールド、フィルタ、スケジュール配信はその上でいつもどおり機能します。

Google のドキュメントでは、サポートされる認証タイプとして OAuth 2.0、USER_PASS、USER_TOKEN、KEY、PATH_USER_PASS、PATH_KEY、NONE の 7 つが挙げられています。認証情報は設定フィールドに入力させるのではなく、ユーザー自身のプロパティ（PropertiesService.getUserProperties）に保存する必要があります。そうすれば、API キーがほかのレポート編集者に見えてしまうことはありません。

必要なのはカスタムコネクタか、パートナーコネクタか、データパイプラインか？

カスタムコネクタを依頼してくるチームの多くは、最終的に別のものが必要だとわかります。コードを書く前に、私はソースについて 3 つの問いを確認します。すでにコネクタは存在するか、各レポートにどれだけのデータが必要か、どの程度の鮮度が求められるか、です。

Data Studio は GA4、Google Ads、Search Console、Sheets、BigQuery、YouTube、Campaign Manager 360、Display & Video 360、Ad Manager、Cloud SQL、MySQL、PostgreSQL、SQL Server、Redshift にネイティブで接続できます。Supermetrics、Windsor.ai、Porter Metrics、Funnel、Power My Analytics、Catchr などのベンダーが提供するパートナーコネクタは、月額料金で数百の一般的なプラットフォームをカバーしています。カスタム開発が意味を持つのは、どちらもソースをカバーしていない場合か、ベンダーがレポートに必要な形にデータを整えられない場合だけです。

コミュニティコネクタは何に接続できるか？

インターネット経由で到達できるものなら、ほぼ何でも接続できます。Google のドキュメントでは、Web API、JDBC データベース、CSV・JSON・XML のフラットファイル、その他の Apps Script サービスという 4 つの経路が挙げられています。実際に私が受ける依頼は、大きく 3 つに分かれます。

1 つ目は、受注プラットフォーム、予約エンジン、保険契約管理ツールなど、API を持つ社内システムです。2 つ目は、大手コネクタベンダーが対応していないニッチな SaaS 製品です。3 つ目は、自社の顧客に Data Studio で自社データのレポートを作ってほしいプロダクト企業で、この場合はコネクタを一般公開する意味があります。

• キーまたはトークン認証を使う社内 REST API。
• API はあるがパートナーコネクタがない業界向け SaaS ツール。
• ネイティブコネクタが対応していない、JDBC 経由で接続できるデータベース。
• 定期的に更新される、ホスティングされた CSV・JSON・XML ファイル。

Data Studio カスタムコネクタの作り方（ステップごと）

開発そのものは小さな部分にすぎません。労力の大半は、フィールドの合意、ソース固有のクセへの対応、そして社内ですでに信頼されている数字との突き合わせテストにかかります。私は次の順序で進めます。

• 範囲の決定：コネクタがデータを供給するレポート、必要なすべてのフィールドとそのデータ型、突き合わせる合計値を一覧にします。
• API の確認：認証方式、ページネーション、レート制限、期間での絞り込み、履歴をどこまで遡れるか。
• 認証：適切な認証タイプを選び、認証情報をユーザープロパティに保存し、キーの期限切れ時にはわかりやすいエラーを出します。
• 設定とスキーマ：ユーザーが選ぶ設定と型付きのスキーマを定義し、ディメンションと指標にはチームが普段使う呼び方で名前を付けます。
• getData：要求されたフィールドと期間だけを取得し、結果をページ送りしながらスキーマに対応付けます。
• キャッシュ：最近のレスポンスを保存し、グラフを何度読み込んでも API を再度呼び出さないようにします。
• エラー：空のグラフではなく読めるメッセージを返します。Data Studio はコネクタが壊れても警告を出さないためです。
• デプロイとテスト：バージョン付きのデプロイを作成し、テスト用レポートで接続し、合計値を突き合わせてからチームに共有します。
• 引き継ぎ：コードはお客様自身の Google アカウントに置き、フィールドと上限をまとめた短いドキュメントとウォークスルーをお渡しします。

コネクタを作る前に想定しておくべき上限は？

上限を決めるのは Apps Script の割り当てなので、まず自社のデータ量と照らし合わせてください。以下の数値は、Google の Apps Script 割り当てのページと Cache サービスのリファレンスに基づいており、いずれも 2026年10月に確認したものです。URL Fetch の数値はスクリプトを実行するアカウントあたりの 1 日の上限で、多くの閲覧者が同時にレポートを開くときに問題になります。

その上で、Data Studio 自体の上限も適用されます。データの統合は最大 5 つのデータソースまでで、結合は等価結合のみです。また、非常に大きなクエリでは行数が多すぎるというエラーが返されます。コネクタを使っても、どちらの上限も解除されません。

カスタムコネクタが遅い理由と、高速に保つ方法

データのリクエストのたびに、ソースに問い合わせる前に Apps Script が実行されます。グラフも閲覧者も多いページでは、リクエストの数も増えます。2025年7月の Google の開発者フォーラム（discuss.google.dev、タイトルは Custom Connectors Very Slow）のスレッドでは、コネクタがハードコードされたごく小さな結果を返すだけでも、グラフの描画に 10 秒以上かかったと開発者が報告しており、解決策は投稿されていませんでした。これは私の経験とも一致します。1 回の呼び出しごとのオーバーヘッドが、ページ上のグラフの数だけ積み重なるのです。

対策の多くは、巧妙なコードではなく設計上の判断です。ページあたりのグラフを減らす、リクエストを絞り込むフィルタを使う、Data Studio に届く前にレスポンスを集計しておく、といったことがすべて効きます。データが大きい場合や API が遅い場合は、BigQuery に定期的に読み込み、Data Studio をパーティション分割テーブルに向ける方が適切です。そうすれば、閲覧時の経路から Apps Script を完全に外せます。

• グラフが要求したフィールドと期間だけを返す。
• Data Studio で 1 行ずつではなく、API 側かキャッシュ層で集計する。
• ユーザーごと・クエリごとにキャッシュし、再訪問で API を呼ばないようにする。
• ページには実際に読まれるグラフだけを置く。
• データ量や閲覧者数が増えたら、BigQuery への定期読み込みに移行する。

コネクタは非公開のままにすべきか、ギャラリーに公開すべきか？

自社のデータを読むものなら、非公開のままにしてください。Google のドキュメントでは、コネクタを任意のユーザーに直接共有できることが確認されています。社内のレポートチームにはそれで十分で、公開製品向けの審査プロセスも避けられます。

ソフトウェア企業で、顧客に自社データのレポートを作ってほしい場合は公開してください。Google のパートナーコネクタの要件は具体的です。本番（Production）デプロイ、Google の審査用アドレスへの閲覧権限の共有、プライバシーポリシーと利用規約を載せた自社ドメイン上のページ、メールリンクではないサポートページ、自社管理下でホスティングしたロゴ、明示的な OAuth スコープ、OAuth クライアント確認の完了、そしてベータ版ではなく完成したコネクタであることが求められます。開発とは別に、この審査の時間も見込んでおいてください。

Data Studio カスタムコネクタの費用はいくら？

主な費用は開発で、運用費は通常わずかです。Apps Script 自体には上記の割り当ての範囲内でライセンス料がかからず、Data Studio は作成者にも閲覧者にも無料です。Data Studio Pro（1 ユーザー・1 プロジェクトあたり月額 $9）は、チームで Pro のワークスペースや組織所有のコンテンツを使いたい場合にのみ必要で、コネクタを使うために必要なわけではありません。

開発費を左右するのはグラフではなくソースです。キー認証、整った JSON、期間フィルタを備えた API なら、比較的小さな作業です。OAuth、深いページネーション、不統一なフィールド名、欠けている履歴、厳しいレート制限は、それぞれ作業を増やします。ギャラリーへの申請はさらに作業を増やします。参考までに、halo-lab.com などのエージェンシーが公開している料金では、フリーランスの Data Studio コンサルタントは 1 時間あたり約 $100～$200 とされていますが、書面の範囲に基づく固定価格の方が比較しやすいでしょう。

比較は正直に行ってください。パートナーコネクタがすでにそのプラットフォームに対応しているなら、そのサブスクリプションの方が、自前のコードを開発・保守するより安いことがよくあります。その場合は、レビューの中でそうお伝えします。

よくある失敗と、カスタムコネクタを作るべきでないケース

失敗したコネクタ案件の多くは原因が共通しており、そのどれもコードの問題ではありません。範囲設定とオーナーシップの問題で、多くは数か月後、誰かが退職したときやソースの API が変わったときに表面化します。

そもそもコネクタが不要なこともあります。複数の保険会社から整っていない .xls ファイルを受け取っていたオーストラリアの保険ブローカーの案件では、私が Greenwolf Tech Labs で主導したプロジェクトで、ファイルを Google Drive に自動で取り込み、ビジネスルールを適用したうえで中央の Google Sheet に対応付け、そこからダッシュボードにデータを供給しました。レポート作成の時間は 4～5 時間から 5 分未満になり、レポートの正確性は約 75% から 99% に向上しました。コネクタではあのファイルの問題は解決できず、パイプラインが解決したのです。

• パートナーコネクタがすでに対応しているプラットフォーム向けに作ってしまう。
• 生の行を取得して Data Studio で集計し、すぐに割り当て上限に達する。
• スクリプトを外部委託先の個人アカウントに置いたままにする。
• API キーをユーザープロパティではなく設定フィールドに入れる。
• 突き合わせを省き、最初のレポートを誰も信用しなくなる。
• ソースがファイルのエクスポートである場合、データが非常に大きい場合、公開後にコードを保守する人がいない場合は作らないでください。

コネクタ案件の進め方

最初のレビューから引き継ぎまで、私が直接担当します。まず API ドキュメントまたはサンプルのエクスポートと、ご希望のレポートを確認し、長く使える最も安い方法（パートナーコネクタ、カスタムコネクタ、または Sheets や BigQuery のパイプライン）をご提案します。無料のレビューの後、その方法の固定見積もりをお出しし、運用費は別途記載します。

コード、デプロイ、データソースは初日からお客様の Google アカウントに置くので、私が関わり続けることに依存するものは何もありません。コネクタが新しいダッシュボードにデータを供給するならそのダッシュボードも構築し、ソースの変更後に既存のレポートが壊れた場合は、代わりにその修復も行えます。