> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Upsertコネクター

## はじめに

HubSpotは、より多くの顧客を獲得するためのインバウンドマーケティングプラットフォームです。HubSpot Upsertコネクターは、チケットデータのアラートをリアルタイムに受け取ります。DomoのHubSpot Upsertコネクターを使用すると、様々なプロパティにもとづいてチケットのデータを取得できます。このコネクターは、DataSetを更新するMerge関数をサポートしており、重複エントリを防ぐことができます。HubSpot APIについて詳しくは、 HubSpotのウェブサイト（[http://developers.hubspot.com/docs/overview](http://developers.hubspot.com/docs/overview)）を参照してください。

HubSpot Upsertコネクターは「クラウドApp」コネクターであり、クラウドに保管されたデータの取得が可能です。Data Centerのウィンドウ上部のツールバーで\*\*\*\*［クラウドApp］\*\*\*\*をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。

HubSpotアカウントには、Data Centerから接続します。このトピックでは、HubSpot Upsertコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「[コネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。

## 必要条件

HubSpotアカウントに接続してDataSetを作成するには、以下が必要です。

* HubSpotのログインに使用するユーザー名とパスワード

## HubSpotアカウントに接続する

このセクションでは、HubSpot Upsertコネクターページの\*\*［認証情報］**および**［詳細］**ペインについて説明します。このページのほかのペインのオプションである**［スケジュール設定］**と**［DataSetに名前を付け、説明を入力］\*\*については、ほとんどのコネクターで共通しています。詳細については、「[コネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。

### ［認証情報］ペイン

DomoのHubSpot Upsertコネクターは、接続にOAuthを使用します。このため、Domo内での認証情報の入力は必要ありません。\*\*［接続］**をクリック（または、Domoに既存のHubSpotアカウントがある場合は**［アカウントを追加］**を選択）すると、HubSpot OAuth画面が開き、HubSpotの認証情報を入力できます。有効なHubSpot認証情報を入力した後は、新しいHubSpot DataSetを作成する際に常に同じアカウントを使用できるようになります。コネクターのアカウントはData Centerの**［アカウント］\*\*タブで管理できます。このタブについて詳しくは、「[コネクターのユーザーアカウントを管理する](/s/article/360042926054)」を参照してください。

<Note>\*\*注記：**Domoで接続する際、既にHubSpotにログインしている場合は、**［アカウントを追加］\*\*をクリックすると自動的に認証されます。ログインしているアカウントとは異なるアカウントに接続したい場合は、まずHubSpotからログアウトする必要があります。</Note>

### ［詳細］ペイン

このペインには、メインとなる\*\*［Reports］\*\*メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

| メニュー                                  | 説明                                                                                                                                                                                                                                                                  |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Report                                | 実行するHubSpotレポートを選択します。以下のレポートを利用できます。<table><tbody><tr><td>Companies</td><td>自分のアカウントで利用可能なすべての会社を取得します。</td></tr><tr><td>Owners</td><td>自分のアカウントで利用可能なすべての所有者を取得します。</td></tr><tr><td>Ticket Report</td><td>このレポートはポータルからすべてのチケットを取得します。</td></tr></tbody></table> |
| Select Company Properties to Retrieve | すべての会社のプロパティを取得するか、特定の会社のプロパティのみを取得するかを選択します。                                                                                                                                                                                                                       |
| Company Properties                    | 会社のプロパティを選択します。                                                                                                                                                                                                                                                     |
| Select Type of Owners                 | すべての所有者を取得するか、アーカイブされた所有者のみを取得するかを選択します。                                                                                                                                                                                                                            |
| Select Properties To Retrieve         | すべてのプロパティのチケットを取得するか、固有のプロパティのみのチケットを取得するかを選択します。                                                                                                                                                                                                                   |
| Properties                            | チケットを取得するプロパティを選択します。                                                                                                                                                                                                                                               |

### その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「[コネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。

## よくある質問

<AccordionGroup>
  <Accordion title="このコネクターのベースURLはどのエンドポイントですか？">
    HubSpot UpsertのベースURLは[https://api.hubapi.comです。](https://api.hubapi.comです。)
  </Accordion>

  <Accordion title="各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？">
    | レポート名         | エンドポイントURL（1つまたは複数）        |
    | ------------- | -------------------------- |
    | Companies     | /crm/v3/properties/company |
    | Owners        | /crm/v3/owners/            |
    | Ticket Report | /crm/v3/objects/tickets    |
  </Accordion>

  <Accordion title="HubSpot Upsertコネクターを作成するにはどのような認証情報が必要ですか？">
    HubSpotメールアドレスとパスワードが必要です。
  </Accordion>

  <Accordion title="データ更新の頻度はどのくらいですか？">
    必要に応じて何回でも更新できます。
  </Accordion>

  <Accordion title="注意すべきAPI制限はありますか？">
    ありません。
  </Accordion>

  <Accordion title="同じHubSpotアカウントを使用して複数のDataSetを作成することはできますか？">
    はい
  </Accordion>

  <Accordion title="HubSpot UpsertコネクターとHubSpotコネクターの違いは？">
    HubSpot Upsertコネクターは、DataSetを更新するためのAppend関数とReplace関数に加えて、Merge関数をサポートしています。Merge関数は、更新された行をすべて置き換え、新しい行を追加します。これにより、重複エントリを避けることができます。\
    HubSpot Upsertコネクターは、DataSetを更新するためのAppend関数とReplace関数をサポートしています。
  </Accordion>
</AccordionGroup>