- HubSpotアカウントにて、メイン ナビゲーション バーにある設定アイコンをクリックします。
- 左のサイドバーメニューで、［連携］＞［非公開アプリ］の順に進みます。
- ［非公開アプリを作成］をクリックします。
- ［基本情報］タブで、アプリの詳細を設定します。
- アプリの名前を入力します。
- プレースホルダーロゴの上にカーソルを合わせると表示されるアップロードアイコンをクリックして、アプリのロゴとして使用する正方形の画像をアップロードします。
- アプリの説明を入力します。
- ［スコープ］タブをクリックします。
- 非公開アプリがアクセスできるように設定するスコープごとに、［読み取り］または［書き込み］チェックボックスをオンにします。［スコープを検索］検索バーを使用して、特定のスコープを検索することもできます。
- アプリの設定が完了したら、右上の［アプリを作成］をクリックします。
- ダイアログボックスで、アプリのアクセストークンの情報を確認してから、［作成を続行］をクリックします。
アプリの作成が完了したら、アプリのアクセストークンを使用して、API呼び出しを開始できます。アプリの情報を編集したりアプリのスコープを変更したりする必要がある場合は、［詳細を編集］をクリックします。
API呼び出しを開始するには、アプリの詳細ページを開きます。
- ［アクセストークン］カード内の［トークンを表示］をクリックして、アクセストークンを表示します。［コピー］をクリックして、トークンをクリップボードにコピーします。
アクセストークンが分からなくなった場合や侵害された場合は、トークンをローテーション（変更）できます。新しいアクセストークンが作成され、元のアクセストークンは失効します。
- HubSpotアカウントにて、メインのナビゲーションバーに表示される設定アイコンをクリックします。
- ［連携］＞［非公開アプリ］の順に進みます。
- 非公開アプリの名前をクリックします。
- アクセストークンの横にある［変更（ローテーション）］をクリックします。
- トークンが侵害され、直ちにアクセスを取り消す場合は、［今すぐこのトークンを変更（ローテーション）して期限切れにする］をクリックします。
- 特に侵害が生じていなくても、トークンは6か月ごとに変更することが推奨されます。トークンを定期的に変更する準備ができている場合は、［後でこのトークンを変更（ローテーション）して期限切れにする］をクリックします。これにより、7日後にトークンが失効します。
- アプリを早く移行する準備ができている場合は、［今すぐ期限切れにする］をクリックします。
- もっと時間が必要だと判断した場合は、［変更（ローテーション）をキャンセル］をクリックし、元のトークンの失効を取り消して、新しいアクセストークンを無効にすることができます。
アプリによる過去30日間のAPI呼び出しを確認するには、以下の手順に従います。
- アプリの詳細ページで、［ログ］タブをクリックします。
- 非公開アプリのAPI呼び出しの確認および絞り込みを行うには、以下の手順に従います。
- ［メソッド］または［レスポンス］ドロップダウンメニューをクリックして、リクエストメソッドまたはレスポンスコードでAPI呼び出しの履歴を絞り込みます。
- ［開始日］または［終了日］ドロップダウンメニューをクリックして、特定の期間でAPI呼び出しログを絞り込みます。
- ［リクエストURLで検索］検索ボックスで、URLを指定して特定の呼び出しを検索することもできます。
- API呼び出しログをエクスポートするには、［ログをエクスポート（CSV）］をクリックします。
- ポップアップボックスで、エクスポートするAPI呼び出しの日付範囲を選択し、［エクスポート］をクリックします。エクスポートの準備ができると、ダウンロードリンクが記載されたEメールが届きます。