データ接続と統合利用可能なコネクターHubSpot

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

HubSpot

Foundry を HubSpot に接続して、データのインポートや HubSpot のレコードの作成、変更、削除を行います。

セットアップ

  1. Data Connection アプリケーションを開き、画面右上の + 新規ソースを選択します。
  2. 利用可能なコネクターの種類から HubSpot を選択します。
  3. 追加の設定プロンプトに従い、以下のセクションの情報を使用してコネクターのセットアップを続行します。

Foundry でのコネクターのセットアップについては、詳しくはこちらをご覧ください。

認証

HubSpot ソースは、プライベートアプリのアクセストークンで認証します。

HubSpot アカウントでプライベートアプリを作成し、そのアクセストークンをコピーします。最新の手順については、HubSpot のプライベートアプリのドキュメント ↗を確認してください。

このコネクターを動作させるには、プライベートアプリが次の要件を満たす必要があります。

  • プライベートアプリを作成するには、HubSpot のスーパー管理者である必要があります。
  • プライベートアプリに付与されたスコープによって、コネクターが探索および同期できるテーブルが決まります。Foundry から使用する予定のすべてのスコープに、読み取りまたは書き込みアクセスを付与してください。

スコープが不足しているプライベートアプリでも、認証は成功します。ソースはエラーなく接続され、トークンでアクセスできないテーブルは通知なくすべて除外されます。そのため、探索に表示されないテーブルがある場合は、通常、接続の問題ではなくスコープの不足を示しています。その後 HubSpot で次の2つの変更を行った場合も、同じ結果になります。HubSpot アカウントのサブスクリプションをダウングレードするとプライベートアプリのスコープが失われ、ローテーションして後で失効の選択肢を使用してアクセストークンをローテーションすると、以前のトークンは7日後に失効します。

ネットワーク

以下のテーブルは、ソースが実行時にアクセスする必要があるドメインを示しています。

Foundry ワーカー接続の場合は、ドメインごとにエグレスポリシーを追加します。

ドメインが別のネットワーク上にあり、Agent プロキシのエグレスポリシー(推奨)または Agent ワーカー(非推奨)を使用する場合、Agent がそれらのドメインに到達できる必要があります。また、それらのドメイン上のシステムが Agent からの接続を許可している必要もあります。Agent のネットワークについては、詳しくはこちらをご覧ください。

ドメイン必須
api.hubapi.com常に必須

接続情報

オプション必須?説明
プライベートアプリトークンはいHubSpot のプライベートアプリからコピーしたアクセストークン。

移行

HubSpot は2022年7月15日に新しい APIキーの作成を停止し、2022年11月30日に APIキー認証をサンセットしました。詳細については、HubSpot の APIキーのサンセットに関する変更履歴 ↗を確認してください。APIキーを使用している既存のソースは、プライベートアプリのアクセストークンに移行する必要があります。

  1. 認証で説明されているとおり、HubSpot でプライベートアプリを作成し、そのアクセストークンをコピーします。
  2. 接続設定 > 接続情報で、資格情報の方式としてプライベートアプリを選択し、アクセストークンを入力します。