Application Integration でサポートされているコネクタをご覧ください。

HubSpot トリガー

HubSpot トリガーは、HubSpot インスタンスに定義したカスタム HubSpot イベントに基づいて統合を呼び出すことができるコネクタイベントトリガーです。

準備

HubSpot トリガーの新しい接続を作成または構成する場合は、プロジェクトに対する次の Identity and Access Management（IAM）ロールがあることを確認してください。

Connectors 管理者（ roles/connectors.admin ）

ロールの付与については、アクセスの管理をご覧ください。

HubSpot トリガーに使用するサービスアカウントに、次の IAM ロールを付与します。

Application Integration の起動元（ roles/integrations.integrationInvoker ）

サービスアカウントへのロールの付与については、サービスアカウントに対するアクセス権の管理をご覧ください。

サポートされているイベントタイプ

Webhook サブスクリプションでは、アプリが受信するイベントを選択できます。次のサブスクリプションタイプがサポートされています。

deal.creation
deal.propertyChange
deal.deletion
contact.creation
contact.propertyChange
contact.deletion

イベントタイプの完全なリストについては、Webhook サブスクリプションをご覧ください。

HubSpot トリガーを追加する

統合に HubSpot トリガーを追加する手順は次のとおりです。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合リスト] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
統合エディタで統合が開きます。
統合エディタのナビゲーションバーで、[トリガー] をクリックして、使用可能なトリガーのリストを表示します。
統合エディタで、HubSpot トリガー要素をクリックして配置します。

HubSpot トリガーを構成するには、Integration Connectors で使用可能な既存の HubSpot 接続を使用するか、インライン接続作成オプションを使用して新しい HubSpot 接続を作成します。

既存の接続を使用して HubSpot トリガーを構成する

Integration Connectors の既存の HubSpot 接続を使用して、HubSpot トリガーを構成できます。HubSpot トリガーはコネクタイベントトリガーであるため、トリガーを構成するには、イベントサブスクリプションを有効にした HubSpot 接続のみが使用できます。

新しい HubSpot 接続を使用して HubSpot トリガーを構成する方法については、新しい接続を使用して HubSpot トリガーを構成するをご覧ください。

既存の HubSpot 接続を使用して HubSpot トリガーを構成する手順は次のとおりです。

統合エディタの HubSpot トリガー要素をクリックして、トリガー構成ペインを開きます。
[トリガーの構成] をクリックします。
[Connector Event Trigger Editor] ページで、構成の詳細を次のとおりに入力します。
1. リージョン: HubSpot 接続のリージョンを選択します。
2. 接続: 使用する HubSpot 接続を選択します。
  Application Integration には、アクティブなイベントサブスクリプションが有効になっている HubSpot 接続のみが表示されます。
3. イベントタイプ: 統合のトリガーに使用するイベントタイプを選択します。サポートされているイベントタイプの一覧については、サポートされているイベントタイプをご覧ください。
4. サービスアカウント: HubSpot トリガーに必要な IAM ロールを持つサービスアカウントを選択します。
[完了] をクリックしてトリガーの構成を完了し、ページを閉じます。

新しい接続を使用して HubSpot トリガーを構成する

新しい HubSpot 接続を使用して HubSpot トリガーを構成する手順は次のとおりです。

統合エディタの HubSpot トリガー要素をクリックして、トリガー構成ペインを開きます。
[トリガーの構成] をクリックします。
[リージョン] フィールドはスキップします。
[接続] をクリックし、プルダウンメニューから [接続を作成] オプションを選択します。
[接続の作成] ペインで次の手順を行います。
1. [ロケーション] ステップで、新しい HubSpot 接続のロケーションを選択します。
  1. リージョン: プルダウンリストからリージョンを選択します。
  2. [次へ] をクリックします。
2. [接続の詳細] セクションで、次の操作を行います。
  1. コネクタ: 使用可能なコネクタのプルダウンリストから [HubSpot] を選択します。
  2. Connector version: 使用可能なバージョンのプルダウンリストからコネクタのバージョンを選択します。
  3. [接続名] フィールドに、接続インスタンスの名前を入力します。
    接続名は次の条件を満たす必要があります。
    - 接続名には英字、数字、ハイフンを使用できます。
    - 文字は小文字のみを使用できます。
    - 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
    - 接続名は 63 文字以内で指定してください。
  4. 必要に応じて、接続インスタンスの [説明] を入力します。
  5. サービスアカウント: 必要なロールを持つサービスアカウントを選択します。
  6. イベントサブスクリプションの接続を使用するには、[イベントサブスクリプションを有効にする] を選択します。これを選択すると、次のオプションが表示されます。
    - エンティティとアクションを使用したイベントサブスクリプションを有効にする: このオプションを選択すると、イベントサブスクリプションとコネクタオペレーション（エンティティとアクション）の両方に対して接続が使用されます。
    - イベントサブスクリプションのみを有効にする: イベントサブスクリプションに対してのみ接続を使用するには、このオプションを選択します。
    これらのどちらを選択した場合でも、以降のステップでイベントの詳細を構成するように求められます。
  7. スキーマ: 使用する HubSpot API のバージョンを指定します。HubSpotV4 が新しい API です。
  8. BrowsableSchemas: このプロパティは、利用可能なスキーマのサブセットに報告されるスキーマを制限します。例: BrowsableSchemas=SchemaA,SchemaB,SchemaC。
  9. Contact プロパティ: List エンティティオペレーションから選択する Contacts エンティティのカンマ区切りフィールド名を入力します。例: fieldA, fieldB, fieldC
  10. Company プロパティ: List エンティティオペレーションから選択する Companies エンティティのカンマ区切りフィールド名を入力します。例: fieldA, fieldB, fieldC
  11. Deals プロパティ: List エンティティオペレーションから選択する Deals エンティティのカンマ区切りフィールド名を入力します。例: fieldA, fieldB, fieldC
  12. Use proxy: 接続用のプロキシサーバーを構成するために、このチェックボックスを選択します。
  13. Proxy Auth Scheme: ProxyServer プロキシへの認証に使用する認証タイプ。
  14. Proxy User: ProxyServer プロキシへの認証に使用されるユーザー名。
  15. Proxy Password: ProxyServer プロキシの認証に使用されるパスワード。
  16. Proxy SSL Type: ProxyServer プロキシへの接続時に使用する SSL タイプ。
  17. 必要に応じて、接続ノードの設定を構成します。
    - ノードの最小数: 接続ノードの最小数を入力します。
    - ノードの最大数: 接続ノードの最大数を入力します。
    ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
  18. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
  19. [次へ] をクリックします。
3. [宛先] セクションに、接続するリモートホスト（バックエンドシステム）の詳細を入力します。
  1. 宛先タイプ: 宛先の詳細は、ホストアドレスまたはサービスアタッチメントとして指定できます。次のいずれかの宛先タイプを選択します。
    - ホストアドレス: 宛先のホスト名または IP アドレスを指定する場合。
    - サービスアタッチメント: 内部 IP アドレスのプライベートエンドポイントを指定する場合。サービスアタッチメントを使用すると、外部ネットワークから内部 IP アドレスを非表示にできます。Private Service Connect 機能を使用して、Google Cloud でサービスアタッチメントを作成できます。Private Service Connect の構成については、マネージドサービスを公開するをご覧ください。
    選択した宛先タイプに基づいて、ホストアドレスまたはサービスアタッチメント名を入力します。
    
    他の宛先を入力するには、[+Add destination] をクリックします。
  2. [次へ] をクリックします。
4. [認証] セクションで、認証の詳細を入力します。
  1. [認証タイプ] を選択し、関連する詳細を入力します。
    HubSpot 接続でサポートされる認証タイプは次のとおりです。
    - 限定公開アプリアクセストークン: 限定公開アプリアクセストークンを含む Secret Manager の Secret を選択します。
      限定公開アプリを使用すると、HubSpot の API を使用して、HubSpot アカウントの特定のデータにアクセスできます。各限定公開アプリがアカウントでリクエストまたは変更できる対象を承認することができ、これにより、限定公開アプリに固有のアクセストークンが生成されます。限定公開アプリで、少なくとも次のスコープの読み取り権限が指定されていることを確認してください。
      - crm.schemas.line_items.read
      - crm.schemas.quotes.read
      - crm.schemas.deals.read
      - crm.schemas.companies.read
      - crm.schemas.custom.read
      - crm.schemas.contacts.read
      詳細については、限定公開アプリをご覧ください。
  2. [次へ] をクリックします。
5. イベントサブスクリプションを有効にしている場合は、接続作成ページに [イベントサブスクリプションの詳細] セクションが表示されます。[イベントサブスクリプションの詳細] ステップで、HubSpot トークンペイロードの検証に使用される認証の詳細を入力します。
  1. クライアントシークレット:（省略可）限定公開アプリのクライアントシークレットの Secret Manager シークレットと、[シークレットバージョン] プルダウンから対応するシークレットバージョンを選択します。
  2. バックエンドアプリケーションと接続間を安全に接続するには、[プライベート接続を有効にする] を選択します。このオプションを選択した場合は、接続の作成後に追加の構成手順を実行する必要があります。詳細については、イベントサブスクリプションのプライベート接続をご覧ください。
  3. デッドレター構成を入力します。デッドレターを構成すると、指定された Pub/Sub トピックに未処理のイベントが書き込まれます。次の詳細情報を入力します。
    1. デッドレタープロジェクト ID: デッドレター Pub/Sub トピックを構成した Google Cloud プロジェクト ID。
    2. デッドレタートピック: 未処理イベントの詳細を書き込む Pub/Sub トピック。
  4. [次へ] をクリックします。
6. レビュー: 接続と認証の詳細を確認します。
7. [作成] をクリックします。

Webhook サブスクリプションを作成、編集する

イベントサブスクリプションの構成を完了するには、HubSpot アプリケーションで Webhook URL を登録する必要があります。したがって、接続が正常に作成されたら、次の追加の手順を実行します。

新しく作成した接続の接続詳細ページに移動し、イベントサブスクリプションの Webhook URL をコピーします。Webhook URL は、次のステップで Webhook サブスクリプションを作成するときに必要になります。
次の図は、HubSpot 接続の詳細ページの [Events listener endpoint] フィールドを示しています。
手順に沿って、HubSpot で Webhook サブスクリプションを作成、編集します。

トリガー出力

HubSpot トリガーがイベント登録の構成を完了するまでに数分かかります。イベントサブスクリプションのステータスは、トリガー構成ペインの [Event Subscription details] で確認できます。

HubSpot トリガーは、次の状態を使用して、イベントサブスクリプションのステータスを示します。

Creating: トリガーがイベントサブスクリプションに登録中であることを示します。
Active: トリガーがイベントサブスクリプションに正常に登録されたことを示します。
Error: 構成されたイベントサブスクリプションに問題があることを示します。

[Event Subscription details] セクションには、イベントサブスクリプションのステータスに加えて、接続リージョン、接続名、イベントサブスクリプション名などの詳細が表示されます。

次の図は、HubSpot トリガーの構成ペインのサンプルレイアウトを示しています。

トリガー出力変数

HubSpot トリガーはイベントごとに、ダウンストリームタスクで使用できる ConnectorEventPayload 出力変数を生成します。出力変数は、出力 HubSpot ペイロードスキーマを含む JSON 形式です。

イベントサブスクリプションを表示する

Integration Connectors で接続に関連付けられているすべてのイベントサブスクリプションの表示と管理を行う手順は、次のとおりです。

[Integration Connectors] > [接続] ページに移動します。
[接続] ページに移動
サブスクリプションを表示する接続をクリックします。
[イベントサブスクリプション] タブをクリックします。
ここでは、接続のすべてのサブスクリプションが表示されます。

HubSpot トリガーを編集する

HubSpot トリガーを編集して、接続構成とイベントサブスクリプションの詳細を変更または更新できます。

HubSpot トリガーを編集する手順は次のとおりです。

統合エディタの HubSpot トリガー要素をクリックして、トリガー構成ペインを開きます。
[Configure HubSpot trigger] をクリックします。
[Connector Event Trigger Editor] ページで、次の操作を行います。
1. 構成済みのイベントサブスクリプションを保持するには、[保持] をクリックします。それ以外の場合は、[削除] をクリックします。
  警告: イベントサブスクリプションを削除すると、そのイベントサブスクリプションを使用して公開されているすべての統合に影響します。このタスクは取り消すことができません。
2. 必要に応じて、接続構成とイベントサブスクリプションの詳細を更新します。
3. [完了] をクリックします。

更新された接続とイベントサブスクリプションの詳細は、トリガー構成ペインの [Event Subscription details] で確認できます。