接続の確立
接続プロファイルの設定
[CData]リボンから[データの取得]をクリックし、[取得元:HubSpot]> 設定済みの接続 を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、[新しいHubSpot 接続]をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。
HubSpot への認証
HubSpot データソースへの接続に使用できる認証方法は2つあります。非公開アプリトークンベースおよびOAuth 認証です。
HubspotV3 スキーマのいくつかのテーブルは、OAuth の仕組みでは動作しないかもしれません。API 制限のため、これらのスキーマはPrivateAppToken ベース認証での使用に限定されます。具体的には、データモデルセクションの各テーブルで、サポートされる認証方法を説明します。
OAuth
AuthScheme は、すべてのOAuth フローでOAuth に設定する必要があります。以下のOAuth フローは、すでに設定済みであることを前提として書かれています。
デスクトップアプリケーション
CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成 を参照してください。OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- OAuthClientId(カスタムアプリのみ):アプリケーションの登録時に割り当てられたクライアントId に設定。
- OAuthClientSecret(カスタムアプリのみ):アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
- CallbackURL(カスタムアプリのみ):アプリケーションの登録時に定義されたリダイレクトURI に設定。
非公開アプリトークン
AuthScheme プロパティをPrivateAppToken に設定し、OAuthAccessToken をアプリケーションのアクセストークンの値に設定するだけで、Hubspot 非公開アプリのトークンを使用した接続が可能です。
HubSpot 非公開アプリのトークンを生成するには次のステップを実行してください。
- HubSpot アカウントで、メインナビゲーションバーにある設定アイコンをクリックします。
- 左のサイドバーメニューから、連携 -> 非公開アプリに移動します。
- 非公開アプリを作成をクリックします。
- 基本情報タブでアプリケーションの詳細(名前、ロゴ、説明)を設定します。
- スコープタブで、非公開アプリケーションがアクセスできるようにしたい各スコープについて読み取りまたは書き込みを選択します。これは、ドライバーが取得できるデータを決定するものです。選択するスコープの推奨は、OAuthRequiredScopes およびOAuthOptionalScopes プロパティを参照してください。
- アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
- アプリケーションのアクセストークンの情報を確認し、作成を続行、トークンを表示の順にクリックします。
- これで、取得したトークンをOAuthAccessToken プロパティに設定できます(OAuthAccessToken は非公開アプリアクセストークンとOAuth アクセストークンに使用されます)。
AuthScheme をPrivateAppToken に設定すると、この認証スキームを強制できます。
接続プロパティ
最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。
接続の管理
HubSpot への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理 を参照してください。
関連項目
- データのクエリ:[データ選択]ウィザードを使用してスプレッドシートにデータをプルします。また、ここではスケジュールされたデータのリフレッシュも設定できます。
- Excel アドインの使用:利用可能なCData Excel 関数 を使用するなど、HubSpot データとやり取りする他の方法が見つかります。