HubSpot CRMおよびマーケティングデータの抽出
HubSpotコネクタは、HubSpotアカウントからデータを抽出します：連絡先、会社、取引、チケット、パイプライン、フォーム、マーケティングメールなど
目的
HubSpotコネクタは、HubSpotアカウントからデータを抽出します：連絡先、会社、取引、チケット、パイプライン、フォーム、マーケティングメールなど。
25種類のエンドポイントで、HubSpot API全体をカバーします：CRM、マーケティング、CMS、自動化、設定。
コネクタは、HubSpot APIから生のJSONを返します。プラットフォームは、入れ子になったオブジェクトを自動的に列にフラット化し、結果をレイクハウスに保存します。手動でスキーマを定義する必要はありません。
前提条件： HubSpotアカウント（APIアクセスには無料プランで十分です。有料プランは必要ありません）で、少なくともテストレコード（連絡先、会社など）がいくつかある必要があります。app.hubspot.com/signup-hubspot/crmでサインアップしてください。
1. APIトークンを取得する
プライベートアプリを作成する
- HubSpotにログイン
- 設定（歯車アイコン）> 統合 > プライベートアプリに移動
- プライベートアプリを作成をクリック
- 名前を付けます（例：
data-connector） - スコープタブに移動し、必要な権限を選択します（次節を参照）
- アプリを作成 > アプリの作成を続けるをクリック
- 生成されたトークンをコピーします（
pat-na1-...またはpat-eu1-...で始まります）
注意： プライベートアプリは、HubSpotのUIで「レガシー」セクションの下に表示されることがありますが、サーバーサイドのAPI統合の標準としては依然として有効です。「個人アクセスキー」はHubSpot CLIでのみ動作し、REST APIでは動作しません。
資格情報を設定する
トークンをHubSpot APIキーフィールドに貼り付けます：
2. 推奨スコープ
最小限のスコープ（基本CRM）
連絡先、会社、取引、チケットを抽出するには：
必要に応じて追加のスコープ
最初は最小限のスコープから始めます。いつでも後でプライベートアプリの設定で追加できます。
3. 利用可能なエンドポイントタイプ
CRM（リレーショナルデータ）
マーケティング
CMS（コンテンツ）
自動化
設定 / 管理
4. Data PlatformでHubSpotソースを追加する
- Data Platformのコネクタで、ソースストアからHubSpotを見つけ、選択をクリックします。
- 手順1からプライベートアプリトークンをHubSpot APIキーフィールドに貼り付けます。
- 接続をクリックして資格情報を確認します。
- エンドポイントを追加をクリックし、ドロップダウンからエンドポイントタイプを選択します（例：
crm_objects）、その後、そのエンドポイントが必要とするパラメータを入力します（例：object_type: contacts、オプションのproperties_filter、オプションのmax_items）。 - このソースで取り込みたい追加のエンドポイントごとに手順4を繰り返します。各エンドポイントはレイクハウス内で別々のテーブルになります。
- ソースに名前を付け、作成をクリックします。
技術名はソースが作成された後は変更できません。Data Platform SDKでソースを開く際に使用されます。
5. クイック例：連絡先を抽出する
- エンドポイント：
crm_objects - オブジェクトタイプ：
contacts - プロパティフィルタ：
email, firstname, lastname, phone, company, jobtitle - 最大アイテム数：
100（または空にしてすべてを抽出）
コネクタは、HubSpot APIから生のJSONを返します。プラットフォームは、入れ子になったオブジェクト（例：properties.emailは列properties_emailになる）を自動的にフラット化し、結果をレイクハウスに保存します。
6. ベストプラクティス
プロパティフィルタを使用する
デフォルトでは、コネクタはHubSpotのネイティブデフォルトセット（連絡先の6つのコアフィールド：email、firstname、lastname、createdate、lastmodifieddate、hs_object_id）を使用します。properties_filterを使用して、特定のプロパティリストを選択します。
max_itemsから始める
設定時に、max_itemsを10または100に設定して、素早くテストします。出力に満足したら、制限を解除します。
パイプラインをリファレンステーブルとして使用する
パイプラインを別々に抽出してリファレンステーブルを取得します。その後、パイプラインとステージフィールドで取引/チケットと結合できます。
properties_metaを使用してフィールドを発見する
properties_metaエンドポイントは、任意のオブジェクトタイプの完全なデータ辞書を返します。どのフィールドが存在し、そのタイプを確認するのに便利です。
7. HubSpot プランの制限
一部のエンドポイントは有料プランが必要です：
プランで利用できないエンドポイントや必要なスコープが不足している場合は、403エラーが返されます。コネクタはこれらのエラーをキャッチしません。抽出はHTTPErrorで失敗します。エンドポイントを選択する前に、プライベートアプリに必要なスコープが有効になっていることを確認してください。
注意： 上記のプラン分類は概算です。403エラーの一部は、プランの制限ではなく、プライベートアプリのスコープが不足していることが原因である場合があります。エンドポイントが403を返す場合は、まずプライベートアプリのスコープ構成を確認してください。
詳細な技術情報（認証の内部構造、完全なエンドポイントリファレンス、スコープ、ページネーション、出力形式、制限）については、HubSpot Technical Referenceを参照してください。
さらに詳しく
当社のソリューションを実装するためのトレーニングや技術サポートが必要な場合は、営業担当者にお問い合わせください、またはこのリンクをクリックして見積もりを依頼し、当社のプロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。
質問をする、フィードバックを送信する、またはData Platformを構築するチームと直接交流するには、専用のDiscord チャネルにアクセスしてください。
OVHcloudサービスについてサポートが必要な場合は、Help Centreでリクエストを作成してください。
ユーザーコミュニティに参加してください。