[lwptoc]

Zuora連携のニーズが高まっている背景

サブスクリプションビジネスの拡大に伴い、契約・請求・売上認識を一元管理できるZuoraは、グローバルで広く採用されており、一方でZuoraのデータをSalesforce、kintone、Marketoなど他のSaaSや社内システムと連携したいというニーズも増加しています。

本記事では、クラウドETLサービス「TROCCO」のConnector Builderを利用し、ノーコードでZuora API連携・データ連携を実現する手順を具体的に解説します。

どういう場合にETLツールの利用が適しているか?|Pre‑BuiltコネクタとETLツールの使い分け

ZuoraはBigQuery、Snowflake、Redshift、Databricks等のクラウドDWHと連携可能な公式Pre-Builtコネクタを提供しています。大規模データ分析を想定した環境ではこれらが有効ですが、一方で、

  • データ加工・変換が必要な業務フロー
  • 複数SaaSとのデータ統合
  • ノーコードによる迅速な業務可視化
  • DWH未導入

といった場合は、ETLツール「TROCCO」との連携がより適しています。

「TROCCO」はデータ転送だけでなく、データのフィルタリング、フォーマット変換、集計、マージなどの加工処理も一連のワークフローとして自動実行が可能です。

これにより、データを最適な形に整えられ、さらに様々な部門向けの分析やレポート作成に活用するデータを作成・転送することができます。この記事の執筆時点では「TROCCO」に公式のZuoraコネクタはありませんが、Connector Builderを利用すれば、ZuoraのAPIをGUIで設定しながら手軽に自作コネクタを作成することができます。

Connector Builderとは?

ETLツールでは一般的に、2つの異なるインターフェース間の接続を可能にする実装のことを、コネクタと呼びます。

Connector Builder は、ユーザー自身で独自コネクタをノーコードで作成できるTROCCOの機能です。

  • OAuth認証(認可コード・クライアントクレデンシャルズ)やAPIキーの設定に対応
  • ページネーションや任意のクエリパラメータに対応
  • 通常のコネクタと同様にスケジュールによる定期実行が可能

※ Connector Builderは TROCCO の Advanced プラン以上のプランでご利用いただける機能です。

【実践編】Zuora API連携カスタムコネクタをConnector Builder で作成してみる

0. 事前準備

カスタムコネクタの作成時にはサービス側のAPIドキュメントを参照が必要となるため、事前に準備しておきましょう。

ZuoraのAPIリファレンスは下記です。

https://developer.zuora.com/v1-api-reference/introduction

Zuora API認証準備(OAuth 2.0)

Zuoraのドキュメントに掲載があるクライアントID/クライアントシークレット発行画面
Zuoraの公式サイトを参照してクライアントID/クライアントシークレットを取得します。

https://developer.zuora.com/docs/get-started/introduction

ここで取得したクライアントID/クライアントシークレットを利用してAPI認証に利用するため、保管しておきます。クライアントシークレットは作成時のみしか表示されないので、必ず安全に控えておいてください。

1. カスタムコネクタの作成

TROCCOの [カスタムコネクタ] メニューから [新規作成] ボタンを押してカスタムコネクタを作成します。

STEP1:

APIドキュメントを確認しながら、各種設定をコネクタ情報・認証情報の設定を行います。
Zuora API の認証方式は OAuth 2.0 クライアントクレデンシャルズフローを採用していますので、認証情報の設定にて、認証種別「OAuth2」、グラントタイプ 「クライアントクレデンシャルズ」を選択します。

  • 基本情報
    • 任意の名前をつけてください。
  • コネクタ情報
    • ベースURL: https://rest.test.zuora.com/
      • ご自身の環境に合わせて適切なURLを設定してください
      • 今回は Central Sandbox 環境で検証するため上記のURLを設定します。
  • 認証情報
    • 認証種別: OAuth2
    • グラントタイプ: クライアントクレデンシャルズ
    • アクセストークンURL:https://rest.test.zuora.com/oauth/token
      • ご自身の環境に合わせて適切なURLを設定してください
    • 認証ヘッダー設定:変更する必要はありません

STEP2:

[エンドポイントを追加] ボタンを押して必要なAPIエンドポイントを追加します。

今回はすべての製品、機能、および対応する製品料金プランと手数料を含む製品カタログ全体を取得できるエンドポイントを追加します。

  • 名前: Products (任意の名前)
  • パス: /v1/catalog/products
  • HTTPメソッド:GET
  • パラメータ:設定しない
    • 利用時に任意のクエリパラメータを指定してリクエストできるようにしたり、毎回固定パラメータでリクエストするなどの設定ができます
  • HTTPヘッダ:設定しない
    • 利用時に任意のリクエストヘッダの指定してリクエストできるようにしたり、毎回固定パラメータでリクエストするなどの設定ができます
  • JSONPathルート:$.products
    • レスポンスを確認してデータの行が格納されている配列形式のキー名をJSONPath記法で記述してください。
  • ページング設定:無効
    • 今回はページング設定は行いませんが、ページベース、オフセットベース、カーソルベースのページングの設定が行えます。
  • ステータスコード設定:デフォルト設定のまま

ここまで設定し、エンドポイントを保存し、さらにカスタムコネクタを保存すればカスタムコネクタの作成は完了です。

2. Zuora APIの接続設定の作成

[接続情報] メニューをクリックし、接続情報一覧画面の右上の [新規作成] ボタンを押して接続情報を作成します。

カスタムコネクタは [その他] のタブの中にあります。

  1. 接続設定を作成したいカスタムコネクタを選択します。
  2. 「接続情報」画面で以下の項目を入力します:
    1. 名前:接続設定の名前
    2. リソースグループ:接続を共有するグループがあれば選択します
    3. クライアントID/クライアントシークレット:事前準備で発行したクライアントID/クライアントシークレットの値を入力します
    4. スコープ:必要に応じて入力(通常は空でも問題ありません)
  3. 入力後、[認証]ボタンをクリックすると、その場でOAuth認証が実行されます。
  4. 認証が成功すると、画面下部に「✅ 認証に成功しました」と表示されます。
  5. 問題がなければ [保存] を押して接続情報を保存します。

これで接続設定の作成は完了です。

3. データ取得のための転送設定の作成

それでは早速、先ほど作ったカスタムコネクタを利用して、製品リストを取得してみます。
[データ転送] > [転送設定] をクリックし、[新規転送設定作成] ボタンを押します。

STEP0:転送元・転送先の選択

転送元と転送先を選択する画面が表示されますので、転送元をクリック、カスタムコネクタを選択します。

カスタムコネクタは [その他] のタブの中にあります。

今回は転送先に Google Spreadsheets を指定します。

STEP1:転送元・転送先の設定

先ほど作ったZuoraの [カスタムコネクタ]、[カスタムコネクタ接続設定]、[取得対象] を選択します。

転送先の設定は通常のTROCCOでの設定と同じように以下を設定してください。

  • Google Spreadsheets接続情報
  • スプレッドシートID
  • シート名

STEP2:スキーママッピング

[次のSTEPへ] ボタンを押すと、スキーマのカラムマッピングが自動的に実行されます。

カスタムコネクタが正しく作成されていれば、取得予定のデータサンプルがプレビューに表示されます。

カラムの型推論とマッピング設定は自動的に行われますが、転送先のカラム名やデータ型はGUI上で任意に編集できます。

STEP3:設定の確認

設定内容に問題なければ [保存して適用] を押します。

これで転送設定の作成は完了です。

4. 転送ジョブの実行

それでは、作成した転送設定を利用し実際にデータを転送してみましょう。

作成した転送設定の画面の右上にある [実行] ボタンを押します。

ジョブの実行時に指定できる項目がありますが、今回は特に変更せず、そのまま実行をクリックしてください。

ジョブの実行ログ画面に切り替わり転送が開始されます。ジョブが正常終了するとステータスが [SUCCESS] に変更になります。

GoogleスプレッドシートにZuoraの製品データが転送できました!
いかがでしょうか?

TROCCO の Connector Builder を利用すると、最小限の設定でAPI連携ができるカスタムコネクタの作成やデータの転送までできることがおわかりいただけたかと思います。

ユースケース

  • DWH未導入でもZuoraデータをGoogleスプレッドシートやkintoneに連携可能
  • Salesforce・MarketoなどのSaaS横断のデータ統合
  • フィルタ・集計・結合等の加工処理もワークフロー機能で自動化

よくある質問(FAQ)

Q. ノーコードでカスタムコネクタを作成・運用できますか?

A. Connector Builder の操作はGUI中心で作成でき、さらにAPIドキュメントをもとに設定に必要な情報を自動で読み取り、最適な内容を提案するAIサポート機能を搭載しているため、深い専門知識がなくても手軽にコネクタの作成が可能です。
一方で、APIドキュメントの理解が必要な場面や、一部、事前準備やAPIキーの発行などでエンジニアリングの知識が必要となることがあります。また、データ統合や加工にはSQLの記述が必要となる場合があるため、非エンジニアでも使いやすいですが、一定の技術的リテラシーがあるとよりスムーズに運用できます。

まとめ

Connector Builder なら、GUIベースで好きなサービスのコネクタを手軽に作成でき、TROCCOの公式コネクタと組み合わせて他のSaaSとのデータ統合や、DWHをはじめ、クラウドアプリケーションやGoogleスプレッドシートなど、さまざまなサービスへのデータ転送がすぐに実現できます。

コネクタの作成時にはWeb APIの知識が必要ですが、一度作成したコネクタは設定画面から簡単に何度でも再利用できます。そのため、一度コネクタを作成すれば、APIの専門知識がない現場担当者でも、手軽にデータ連携や運用の自動化が実現でき、結果として設計・実装・運用にかかる負担を大幅に削減し、開発・保守の効率向上につながります。

また、Connector Builderで作成したカスタムコネクタは、TROCCOの公式コネクタと同様のパフォーマンス・セキュリティを兼ね備えており、TROCCOに搭載されているワークフロー/定期実行/通知などの運用保守機能も利用できるため、自社で実装から運用まで行う場合と比較し、大幅なコスト削減が期待できます。Zuora連携やAPIデータ連携の初期開発・運用コストを最小化したい場合、「TROCCO」のConnector Builderは有力な選択肢となります。

ぜひ無料トライアルでその使いやすさを体験してみてください!

Connector Builder は TROCCO の Advanced プラン以上のプランでご利用いただける機能です。Connector Builder は2025年7月1日正式リリースを迎えたTROCCOの新機能です。詳細な技術仕様についてはお問い合わせください。

TROCCO ライター

TROCCOブログの記事ライター データマネジメント関連、TROCCOの活用記事などを広めていきます!