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