OAuthの利用

OAuthは、アプリをユーザーアカウントに接続するためにパスワードではなく認証トークンを使用するセキュリティーで保護された認証手段です。OAuthのアクセスを開始することは、ユーザーが自分のHubSpotアカウント上にアプリをインストール（英語）できるようにするための最初のステップです。

すべてのアプリ開発者への注意事項：複数のHubSpotアカウントによるインストール用に設計されたアプリ、またはアプリマーケットプレイスに掲載されるアプリでは、OAuthを使用する必要があります。APIキーを使用している場合、アプリ掲載は却下されます。 

お勧めの参考資料

• OAuthクイックスタートガイドでは実際に動くサンプルアプリを使って作業に慣れていただけます。
• HubSpotアカデミーチュートリアル（英語）はHubSpotでOAuthを短時間で使い始めるための導入資料です。HubSpot-OAuthフローの詳細や、アクセストークンの更新方法が記載されています。

OAuth 2.0との連携を開始する

1. OAuthを使用するための最初のステップは、HubSpot開発者アカウントでアプリを作成することです。これにより、アプリ設定の認証ページでアプリのクライアントIDとクライアントシークレットを確認できるようになります。

2. 下記のように、クライアントIDとクライアントシークレット、およびクエリーパラメーターとスコープを使用して、認証URLを作成します。 

3. アプリをインストールするユーザーを認証URLに誘導し、ユーザーが（複数アカウントを利用している場合は）アカウントを選択する画面を表示して、連携機能へのアクセスを許可できるようにします。アクセスを許可した後、コード クエリー パラメーターが付加されたredirect_url経由のリダイレクトにより、ユーザーはアプリに戻ります。貴社はこのコードとクライアントシークレットを使用して、access_tokenとrefresh_tokenをHubSpotから取得することになります。

認証URLの例

https://app.hubspot.com/oauth/authorize?client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&scope=contacts%20automation&redirect_uri=https://www.example.com/

リダイレクトURLの例

https://www.example.com/?code=xxxx

エラーの例

https://www.example.com/?error=error_code&error_description=Human%20readable%20description%20of%20the%20error

4. access_tokenを使用して、HubSpotアカウントに対して行うAPI呼び出しを認証します。

5. access_tokenの有効期限が切れたら、ステップ3のrefresh_tokenを使用して新しいaccess_tokenを生成します。

注：最初の2つのステップを完了しない限り、アプリはユーザーの連携設定で接続されたアプリとして表示されません。アプリが「接続済み」として表示されるには、リフレッシュトークンと初回アクセストークンを生成することが必要です。

クエリーパラメーター

このパラメーターは、アプリの認証URLを作成する際に必要です。

次に任意指定のものを示します。

スコープ

OAuthは、アプリのスコープまたはアクセス許可の設定を必要とします。各スコープによって、一連のHubSpot APIエンドポイントへのアクセス権が与えられます。また、アプリに対しユーザーが自分のHubSpotアカウント上の特定のツールへのアクセスを許可できるようになります。 

特定のAPIまたはエンドポイントへのアクセスは、HubSpotアカウントのティアによって異なります。下記の表に、利用可能なスコープとアクセス可能なエンドポイントの完全なリストを示します。タイプが異なるHubSpotアカウント上で機能するアプリの場合は、optional_scopeパラメーターを使用して、使用する任意のティアスコープを含めることができます。これにより、すべてのスコープにアクセスできないCRMのみのアカウントを使用している顧客も、アプリを認証できるようになります。認証されていないすべてのスコープについては、アプリ側で確認および処理する必要があります。

関連ドキュメント

HubSpotでの認証方式

OAuthクイックスタートガイド

トークンの管理