メインコンテンツへスキップ

Hubspot APIを使うには?

  1. ダッシュボード画面右上に配置された「設定」ボタンをクリック
restapi-part03-jp image 1
  1. 連携の「APIキー」のメニューからAPIキーを生成します
restapi-part03-jp image 2

データの読み込み

パッケージの作成

今回はテンプレートを利用してパッケージを作成します。
restapi-part03-jp image 3
すでに構築済みのパッケージが作成されます。
restapi-part03-jp image 4

接続URLの変更

接続時のURLをテンプレートで設定された変数を使用したURLではなく、変数部分を明示的に固定値に変更するだけで、コンタクト情報を取得することが可能です。 元URL: $url?hapikey=$api_key&count=250 変更後: https://api.hubapi.com/contacts/v1/lists/all/contacts/all?hapikey=<APIキー>&count=250
restapi-part03-jp image 5
プレビューすると以下のようにデータがJSON形式で取得できることが確認できます。
restapi-part03-jp image 6

変換

メールアドレスを1つの列として独立して取得する方法

  1. データプレビューにもどって、メールアドレスが格納されているJSONパスを取得します。 JSONパス: $.[2].identity-profiles.[0].identities.[0].value
restapi-part03-jp image 7
  1. 上記のJSONパスを元に変換式を定義します。 JsonExtractScalar(identity_profiles,'$.[0].identities.[0].value') 注)「identity-profiles」がXplentyにより「identity_profiles」と自動的にカラム名が変更されている点に注意していください。
  • JsonExtractScalar: 関数。 使い方: JsonExtractScalar(引数1,引数2)
    • 引数1: String型のJSON文字列が格納されたフィールドや変数
    • 引数2: JSONパスをシングルクォートで囲み指定する
    • 返り値: String型
  • identity_profiles: フィールド名。JSON文字列が格納されている(String型)
restapi-part03-jp image 8
  1. データ送信先は、デフォルトのRedshiftを削除し、Snowflakeに送信するように変更します。
restapi-part03-jp image 9

Xplentyでジョブ実行結果を確認する

Hubspotより3件のレコードが更新されていることを確認できました。
restapi-part03-jp image 10
restapi-part03-jp image 11
最終更新日 2026年7月13日