> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# アプリ開発の概要

> HubSpotの開発者ツールと開発者アカウントについてご紹介します。連携の開発、マーケットプレイスへのアプリ掲載、テストアカウントの作成の際にご活用ください。

アプリを使用することで、HubSpotアカウントへのAPI呼び出しを認証したり、Webhookを使ってイベントを通知したり、カスタムカードなどでHubSpot UIを拡張したりできます。HubSpotは、連携のニーズに応じて数種類のアプリと拡張機能を提供しています。このページでは、HubSpotで開発できるアプリと拡張機能の種類、その開発を開始する方法、開発したアプリや拡張機能をHubSpotで管理する方法について詳しくご紹介します。

## アプリの種類

どんな種類の連携機能を構築しようとしているかに応じて、適切な種類のアプリを選択する必要があります。以下では、開発できるアプリの種類とそれらがサポートする機能について詳しく説明します。

拡張機能の開発については、[以下の参照表](#supported-extensions-by-app-type)で、どの種類のアプリでどの拡張機能を開発できるのかについての概要をご確認いただけます。

### 非公開アプリ

非公開アプリは、1つのHubSpotアカウント用に作成することができ、1回限りのスクリプトや単一目的の拡張機能に最適です。一般的に、非公開アプリの実装は公開アプリよりも単純です。非公開アプリはアクセストークンで認証され、HubSpotアプリマーケットプレイスには掲載不可です。

例えば、次のような目的でHubSpotアカウント用の非公開アプリを開発できます。

* APIを介して新しいカスタムオブジェクトを作成する。
* CSVファイルからCRMレコードをインポートする。
* カスタム自動化アクションとチャットボットでAPI要求を認証する。
* [Webhookサブスクリプションを作成および編集](/apps/legacy-apps/private-apps/create-and-edit-webhook-subscriptions-in-private-apps)します。

どのようなときに非公開アプリを開発するかの詳細については、[こちら](https://developers.hubspot.com/blog/hubspot-integration-choosing-private-public-hubspot-apps)をご覧ください。この種類のアプリがニーズに合っている場合は、[HubSpotアカウントで非公開アプリのを作成](/apps/legacy-apps/private-apps/overview)を始めてみましょう。

#### プロジェクト内の非公開アプリ（ベータ版）

開発者プロジェクトフレームワークを使用して構築された非公開アプリを使用すると、CRMレコード用のUI拡張機能とヘルプデスクプレビューパネルを作成できます。標準のHubSpotアカウントで非公開アプリ用のUI拡張機能を作成するには、**Sales Hub**または**Service Hub Enterprise**のサブスクリプションが必要です。ただし、[開発者テストアカウント](/getting-started/account-types#developer-test-accounts)では、これらのツールを無料でお試しいただけます。

利用を開始するには、まず[アカウントをベータ版に登録](https://developers.hubspot.jp/docs/guides/crm/overview#get-started-with-private-apps)し、その後[クイックスタートガイド](/apps/developer-platform/build-apps/overview)に従ってください。

### 公開アプリ

公開アプリは複数のアカウントにインストール可能です。非公開アプリで開発できるような拡張機能に加えて、公開アプリでは次のような高度な機能がサポートされます。

* Webhooks APIを使用してアカウント全体のイベントを通知する。
* タイムラインイベントAPIを使用して、CRMレコードでカスタム タイムライン イベントを作成する。
* HubSpotでカスタムアプリ設定ページを作成する。

公開アプリはOAuthで認証され、HubSpotアプリマーケットプレイスに掲載可能になります。どのような場合に公開アプリを開発するかの詳細については、[こちら](https://developers.hubspot.com/blog/hubspot-integration-choosing-private-public-hubspot-apps)をご覧ください。

この種類のアプリがニーズに合っている場合は、[アプリ開発者アカウントで公開アプリを作成する](/apps/legacy-apps/public-apps/overview)ことができます。

#### プロジェクト内の公開アプリ（ベータ版）

開発者プロジェクトフレームワークを使用して構築された公開アプリを使用すると、CRMレコード用のUI拡張機能とヘルプデスクプレビューパネルを作成できます。この方法で作成した公開アプリに、他の拡張機能を含めることもできますが、これらの拡張機能は従来と同様に、HubSpotおよびAPIを使用して管理する必要があります。

ベータ版に登録している場合は、[クイックスタートガイド](/apps/developer-platform/build-apps/overview)に従って利用を開始するか、[既存の公開アプリをプロジェクトフレームワークに移行する](/apps/developer-platform/build-apps/overview)方法をご確認ください。

### サポートされる拡張機能（アプリの種類別）

| アプリの種類 | サポートされる拡張機能                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 非公開アプリ | [UI拡張機能](https://developers.hubspot.jp/docs/guides/crm/ui-extensions/overview)は、[プロジェクトで作成された非公開アプリ（ベータ版）](/apps/developer-platform/build-apps/overview)でサポートされます。                                                                                                                                                                                                                                                                                                                               |
| 公開アプリ  | <ul><li>[電話拡張SDK](/api-reference/crm-calling-extensions-v3/guide)</li><li>[従来のCRMカード](/api-reference/crm-public-app-crm-cards-v3/guide)</li><li>[タイムラインイベント](/api-reference/crm-timeline-v3/guide)</li><li>[ビデオ会議拡張機能](/api-reference/crm-video-conferencing-extension-v3/guide)</li></ul>[UI拡張機能](https://developers.hubspot.jp/docs/guides/crm/ui-extensions/overview)は、[、プロジェクトで作成された公開アプリ（ベータ版）](https://developers.hubspot.jp/docs/guides/crm/public-apps/creating-public-apps)でサポートされています。 |

<Info>
  \*従来のCRMカードは、プロジェクトで[UI拡張機能として作成](https://developers.hubspot.jp/docs/guides/crm/ui-extensions/create)できるアプリカードとは異なります。UI拡張機能には、一層高度な機能とカスタマイズ可能なコンポーネントがあります。
</Info>

## アプリ開発のためのアカウントの種類

アプリ開発者アカウントとテストアカウントは互いに関連しますが、その用途は異なります。

* アプリ開発者アカウントは、アプリを開発し、アプリマーケットプレイスに掲載するために使用します。
* 開発者テストアカウント（開発者アカウントで作成できます）は、実際のHubSpotアカウントのデータに影響を与えずに、開発したAPIやアプリをテストするために使用します。
* **Sales Hub**または**Service Hub Enterprise**のサブスクリプションをお持ちの場合は、標準のHubSpotアカウントで[開発用サンドボックス](/getting-started/account-types#development-sandbox-accounts-beta-)を使用して、アカウントのデータやアセットに影響を与えることなく、迅速に反復処理を行えます。

HubSpotのアカウントタイプに関する詳細は、[こちらのページ](/getting-started/account-types)をご確認ください。

## 認証

1つのHubSpotアカウントとのカスタム連携を開発する場合は、[非公開アプリ](/apps/legacy-apps/private-apps/overview)を作成し、その[アクセストークン](/api-reference/auth-oauth-v1/guide)を使ってAPI呼び出しを認証するか、公開アプリで[OAuth](/apps/legacy-apps/authentication/working-with-oauth)を使用することができます。複数のHubSpotアカウントによるインストール用に設計されたアプリ、またはアプリマーケットプレイスに掲載されるアプリでは、OAuthを使用する必要があります。

Webhookに登録するか、[アプリのOAuth](/apps/legacy-apps/authentication/working-with-oauth)を設定する場合は、[開発者アカウントを作成する](https://app.hubspot.com/signup-hubspot/developers)必要があります。開発者アカウントでは、アプリマーケットプレイスに[アプリを掲載](/apps/developer-platform/list-apps/listing-your-app)したり、[テストアカウントを作成](/getting-started/account-types)したりすることもできます。

### 開発者APIキー

APIを介してアプリの設定を管理するには、開発者APIキーを使用できます。このAPIキーは、非推奨の標準APIキーとは別のものです。開発者APIキーを使用すると、[Webhooks API](https://developers.hubspot.jp/docs/guides/api/app-management/webhooks/overview)のサブスクリプションを管理したり、[タイムラインイベント機能用のイベントタイプを作成、更新](/api-reference/crm-timeline-v3/guide)したりできます。その他全てのAPI呼び出しは、[非公開アプリのアクセストークン](/api-reference/auth-oauth-v1/guide)またはOAuthを使用して行う必要があります。

アプリ開発者アカウントのAPIキーにアクセスするには、次の手順で進めます。

* アプリ開発者アカウントで、左側のナビゲーションバーにある\*\*［キー］＞「開発者APIキー］\*\*に移動します。

<Frame>
  <img src="https://www.hubspot.jp/hubfs/Knowledge_Base_2023_2024/new-nav-instructions-developer-api-key-0.png" alt="developer-api-key-navigation" />
</Frame>

* \*\*［キーを作成］\*\*をクリックします。

<Frame>
  <img src="https://www.hubspot.jp/hubfs/Knowledge_Base_2023_2024/updated-developer-api-key-create-button.png" alt="create-developer-account-api-key" />
</Frame>

* キーが作成されたら、\*\*［キーを表示］**をクリックします。キーが表示されたら、キーの横にある**［コピー］\*\*をクリックします。

<Frame>
  <img src="https://www.hubspot.jp/hubfs/Knowledge_Base_2023_2024/copy-developer-api-key-updated.png" alt="開発者アカウントAPIキーを表示" />
</Frame>

* キーに関連付けられた最近のセキュリティー操作のリストを確認するには、\*\*［監査ログを表示］\*\*をクリックします。
* 現在のAPIキーをローテーションすることもできます。\*\*［アクション］**ドロップダウンメニューをクリックし、**［キーをローテーション］**の上にカーソルを置いてから**［今すぐこのキーを無効化してローテーションする］\*\*をクリックします。

<Frame>
  <img src="https://www.hubspot.jp/hubfs/Knowledge_Base_2023_2024/rotate-developer-api-key-updated-1.png" alt="show_dev_api_key" />
</Frame>

* 新しいキーを再生成せずにキーを無効にするには、\*\*［アクション］**ドロップダウンメニューをクリックし、**［キーを無効化］**の上にカーソルを重ねて**［今すぐこのキーを無効化する］\*\*をクリックします。

## 開発者アカウントを削除

インストール済みのアプリ、またはマーケットプレイスに掲載されているアプリがアカウントに存在しない場合は、そのアプリ開発者アカウントを削除できます。インストール済みのアプリ、またはマーケットプレイスに掲載されているアプリが存在するアカウントの削除をご希望の場合は、カスタマーサポートまでご連絡ください。

一旦削除したアカウントには、アクセスできなくなります。複数のHubSpotアカウントを切り替えて使用している場合は、削除済みのアカウントが表示されなくなります。

HubSpot API開発者アカウントで、右上のアカウント名をクリックし、\*\*［アカウント］\*\*をクリックします。

<Frame>
  <img src="https://f.hubspotusercontent00.net/hubfs/53/account.jpeg" alt="account" />
</Frame>

\*\*［アカウントを削除］\*\*をクリックします。インストール済みのアプリ、またはマーケットプレイスに掲載されているアプリがアカウントに存在する場合、このボタンは無効になります。

<Frame>
  <img src="https://f.hubspotusercontent00.net/hubfs/53/Account2.jpg" alt="Account2" />
</Frame>

ダイアログボックスにアカウントIDを入力して\*\*［開発者アカウントを削除］\*\*をクリックします。

<Frame>
  <img src="https://f.hubspotusercontent00.net/hubfs/53/Confirm2.jpg" alt="Confirm2" />
</Frame>
