開発者ツールとアカウント
HubSpotには、アプリまたは連携を実現するための数多くのツールが用意されています。1つのHubSpotアカウントとのカスタム連携を開発する場合は、非公開アプリを作成するか、APIキーを使用することができます。Webhookに登録するか、アプリのOAuthを設定する場合は、開発者アカウントを作成する必要があります。開発者アカウントから、アプリマーケットプレイスにアプリの掲載やテストアカウントの作成を行うこともできます。
注:開発者アカウントは、メインのHubSpotアカウントに影響を与えることなく機能をテストするためのサンドボックスアカウントとは異なります。
テストアカウントを作成できるのは開発者アカウント内に限られます。HubSpot上の実データに影響を与えることなく連携をテストするには、テストアカウントを作成するほうがよい場合もあります。
HubSpotでのアプリの目的は?
配信とセキュリティー:
アプリは、HubSpotユーザー(または特定のHubSpotアカウント)に提供する機能がパッケージ化されたものと見なすことができます。OAuthでのアプリ認証により、このパッケージは連携を接続しているユーザーにとって安全な状態に保たれます。
API条件:
HubSpot上でアプリを提供するためには、CRMカード、タイムラインイベント、およびWebhook機能を使用する必要があります。必須ではありませんが、Ecommerce Bridge(eコマースブリッジ)を強くお勧めします。
開発者アカウントとテストアカウントの関係は?
開発者アカウントとテストアカウントは関連がありますが、用途は異なります。開発者アカウントではアプリを開発して掲載ができます。テストアカウント*では、実際のHubSpotアカウントのデータに影響を及ぼすことなく、作成中のアプリのテストを実施できます。テストアカウントは90日で失効しますが、手動で更新でき、OAuth呼び出しの時点で自動更新されます。テストアカウントは、開発者アカウントでのみ作成および管理できます。したがって、開発者アカウントが前提になります。
*開発者アカウントにつき最大10件のテストアカウントを作成できます。
開発者アカウントAPIキー
開発者APIキーは、API経由でHubSpotアプリ設定を管理するために使用します。Webhook APIのサブスクリプション管理、タイムラインイベント機能のためのイベントタイプの作成または更新、Ecommerce Bridgeの設定の更新などに使用します。
前述のように開発者APIキーは、API呼び出しによりアプリの設定を更新するためにのみ使用できます。その他のAPI呼び出しは全て、アカウントの固有のAPIキー(開発者APIキーとは異なります)を使用して、またはOAuth接続を通じて行う必要があります。
開発者APIキーを取得するには、開発者アカウントのアプリダッシュボード上部にある[HubSpot APIキーを取得]ボタンをクリックします。
これにより、モーダルダイアログが開き、開発者APIキーとユーザーIDが表示されます(セキュリティー強化のため、[キーを表示]のクリックが必要です)。
開発者APIキーが漏えいした場合は無効にし、[キーの再生成]ボタンを使用して新たに生成することができます。
アプリID
アプリIDは、次の2か所にあります。
開発者アカウントのアプリダッシュボード、アプリ名の下:
またはアプリの認証設定:
アプリ動作のモニタリング
HubSpotでは、OAuthのアクセストークンを使用した受信リクエストやWebhookまたはCRMカードの発信リクエストを含め、接続されているアプリとの間でやり取りするリクエストが全て記録されます。
アプリ モニタリング ツール:
このリクエストログを表示するには、アプリの設定ページに進み、左のサイドバーの[モニタリング]をクリックします。リクエストのタイプごとに独自のセクションがあり、ドロップダウンメニューのオプションを使用して絞り込むことができます。
リクエストの詳細:
個々のリクエストをクリックして、その詳細情報を確認します。成功したリクエストについては基本情報のみが表示されますが、エラーの場合はさらに詳細が表示されます。
注:リクエストヘッダーと、レスポンスのヘッダーおよび本文は、エラーが発生したリクエストについてのみ記録されます。成功したリクエストについては、リクエストの方法、パス、および時間だけが記録されます。
API呼び出し:
API呼び出しログには、OAuthアクセストークンを使用してアプリに対して行われた全てのリクエストが表示されます。HTTPメソッド、レスポンスコード、期間、またはリクエストURLで絞り込むことができます。
Webhook:
Webhookタブには、アプリのWebhookサブスクリプションに関するHubSpotのリクエストが表示されます。レスポンス(タイムアウトや接続失敗など)、ステータス(成功、再試行、失敗)、サブスクリプションタイプ、期間、試行、イベント、アカウントIDによって絞り込みます。注:試行IDは、特定のリクエストのsubscriptionId
、eventId
、およびattemptNumber
を組み合わせたものです。
CRM拡張機能:
アプリのCRMカードに関するHubSpotのリクエストは、[CRM拡張機能]タブにあります。拡張オブジェクトタイプ、CRMオブジェクトタイプ(コンタクト、会社、チケット、または取引)、エラーまたは警告のタイプ、期間、リクエストID、またはCRMオブジェクトID(特定のコンタクトID)で絞り込みます。
開発者アカウントの削除
インストール数があるアプリ、またはマーケットプレイスに掲載されているアプリがないAPI開発者アカウントはユーザーが削除できます。インストール数があるアプリ、またはマーケットプレイスに掲載されているアプリがあるアカウントを削除する場合は、サポートまでご連絡ください。
一旦削除したアカウントには、アクセスできなくなります。複数のHubSpotアカウントを切り替えて使用している場合は、削除済みのアカウントが表示されなくなります。
HubSpot API開発者アカウントで、右上のアカウント名をクリックし、[アカウント]をクリックします。
[アカウントを削除]をクリックします。インストール数があるアプリ、またはマーケットプレイスに掲載されているアプリがアカウントにある場合、このボタンは無効化されます。
ダイアログボックスで、アカウントIDを入力してから、[開発者アカウントを削除]をクリックします