インポート

CRMデータを一括インポートする

インポートは、営業、マーケティング、およびサービスのさまざまなツールで使用できるオブジェクト(コンタクト、会社、取引、チケットなど)のデータをHubSpotアカウントに取り込むために使用します。インポートには、ExcelやCSV(カンマ区切り値)など、構造化されたソースファイルが必要です。1つの構造化ファイルから、大量のオブジェクトを一度にアカウントにインポートすることが可能です。

使用例:インポートエンドポイントを使用すると、ExcelまたはCSV(カンマ区切り値)ソースファイルからHubSpot上にオブジェクトを作成できます。リクエスト値fileFormatには、使用するインポートファイルの形式の指定します。このfileFormatリクエスト値の既定値はCSVです。Excelスプレッドシートの場合に使用する値はSPREADSHEETです。使用する日付形式を指定するためのdateFormatというリクエスト値もあります。MM/DD/YYYYDD/MM/YYYYYYYY/MM/DDの日付形式に応じて、MONTH_DAY_YEAR(既定)、DAY_MONTH_YEARYEAR_MONTH_DAYを指定します。

前方(将来の)互換性を担保するために、columnObjectTypeの代わりにcolumnObjectTypeIdを使用してください。HubSpotネイティブオブジェクトのobjectTypeIdは下の表に示します。カスタムオブジェクトの場合の値は、カスタムオブジェクトAPI(英語)を使用して取得できます。 

「エンドポイント」タブに記載の「Get information on any import(インポートに関する情報の取得)」エンドポイントでは、importIdフィールドに整数の引数を渡します。2018年8月よりも前の時点では、importIdは英数字でした。このエンドポイントは、2018年8月以降に作成されたインポートでの使用を想定しています。

          
Example POST URL:
https://api.hubapi.com/crm/v3/imports?

importRequest JSON データの例:
このサンプルには4つの列があります。
 - 名、コンタクトプロパティーfirstnameとマッピングされる
 - Eメール、コンタクトプロパティーemailとマッピングされる
 - 会社ID、コンタクトが関連づけられる
   会社レコードIDのリストを含む
 - クローズ日、コンタクトプロパティーclosedateとマッピングされる 

{
  "name": "test_import",
  "files": [
    {
      "fileName": "final_emails.csv",
      "fileFormat": "CSV",
      "dateFormat":"DAY_MONTH_YEAR",
      "fileImportPage": {
        "hasHeader": true,
        "columnMappings": [
          {
            "ignored": false,
            "columnName": "First Name",
            "idColumnType": null,
            "propertyName": "firstname",
            "foreignKeyType": null,
            "columnObjectTypeId":"0-1"
            "associationIdentifierColumn": false
          },
          {
            "ignored": false,
            "columnName": "Email",
            "idColumnType": "HUBSPOT_ALTERNATE_ID",
            "propertyName": "email",
            "foreignKeyType": null,
            "columnObjectTypeId":"0-1",
            "associationIdentifierColumn": false
          },
          {
            "ignored": false,
            "columnName": "Company ID",
            "idColumnType": "HUBSPOT_OBJECT_ID",
            "propertyName": null,
            "columnObjectTypeId":"0-2",
           "associationIdentifierColumn": false
          },
         {
            "ignored": false,
            "columnName": "Close date",
            "idColumnType": null,
            "propertyName": "closedate",
            "foreignKeyType": null,
            "columnObjectTypeId":"0-1",
            "associationIdentifierColumn": false
          }
        ]
      }
    }
  ]
}
オブジェクト名 objectTypeId
コンタクト 0-1
会社 0-2
取引 0-3
チケット 0-5
コメント 0-4

 

制限

インポートの上限として、500,000行または400 MBのうち、最初に到達した条件が適用されます。データがこの制限に近づいた場合、インポートを複数のリクエストに分割することをお勧めします。リクエストが行制限またはサイズ制限のいずれかを超えた場合、429のHTTPレスポンスコードが返されます。  


Share your feedback

Was this page helpful? *
This form is for feedback on our developer docs. If you have feedback on the HubSpot product, please share it in our Idea Forum instead.