リードの一括読み込み

最終更新日： 2024年7月20日
  • トピック：

作成対象：

  • 管理者

一括リード読み込みエンドポイントのリファレンス

大量のリードレコードの場合、リードは bulk API を使用して非同期でインポートできます。 これにより、区切り文字（コンマ、タブ、またはセミコロン）を含むフラットファイルを使用して、レコードのリストをMarketoにインポートできます。 ファイルには任意の数のレコードを含めることができます（ファイルの合計サイズが 10 MB 未満である場合）。 レコード操作は、「挿入または更新」のみです。

処理制限

制限を持つ複数の一括読み込みリクエストを送信できます。 各リクエストは、処理される FIFO キューにジョブとして追加されます。 最大 2 つのジョブが同時に処理されます。 任意の時点でキューに入れられるジョブの数は最大 10 個です（現在処理中の 2 個を含む）。 ジョブの最大数 10 を超えると、「1016, Too many imports」エラーが返されます。

ファイルのインポート

ファイルの最初の行は、各行の値をマッピングするために対応する REST API フィールドをリストするヘッダーである必要があります。 一般的なファイルの形式は、次のような基本的なパターンになります。

email,firstName,lastName
test@example.com,John,Doe

「externalCompanyId」フィールドを使用すると、リードレコードを会社レコードにリンクできます。 「externalSalesPersonId」フィールドを使用して、引合レコードを販売担当者レコードにリンクできます。

呼び出し自体は、multipart/form-data の content-type を使用して行われます。

このリクエストタイプは実装が困難な場合があるので、既存のライブラリ実装を使用することを強くお勧めします。

ジョブの作成

一括読み込みリクエストを行うには、content-type ヘッダーを「multipart/form-data」に設定し、少なくともファイルコンテンツを含むファイルパラメーターと、ファイル形式を示す値「csv」、「tsv」、「ssv」を持つ形式パラメーターを含める必要があります。

POST /bulk/v1/leads.json?format=csv

Content-Type: multipart/form-data; boundary=------WebKitFormBoundaryBQACkJZyaiIAXogC
Content-Length: 311
Host: <munchkinId>.mktorest.com

------WebKitFormBoundaryBQACkJZyaiIAXogC
Content-Disposition: form-data; name="file"; filename="leads.csv"
Content-Type: text/csv

FirstName,LastName,Email,Company
Able,Baker,ablebaker@marketo.com,Marketo
Charlie,Dog,charliedog@marketo.com,Marketo
Easy,Fox,easyfox@marketo.com,Marketo
------WebKitFormBoundaryBQACkJZyaiIAXogC--

{
    "requestId": "d01f#15d672f8560",
    "result": [
        {
            "batchId": 3404,
            "importId": "3404",
            "status": "Queued"
        }
    ],
    "success": true
}

このエンドポイントは multipart/form-data を content-type として使用します。 正しく設定するまでには時間がかかるので、ベストプラクティスは HTTP サポートライブラリを使用して目的の言語を選択することです。 コマンドラインから cURL を使用してこれを行う簡単な方法は、次のようになります。

curl -i -F format=csv -F file=@lead_data.csv -F access_token=<Access Token> <REST API Endpoint Base URL>/bulk/v1/leads.json

読み込みファイル「lead_data.csv」には次の内容が含まれています。

FirstName,LastName,Email,Company
Able,Baker,ablebaker@marketo.com,Marketo
Charlie,Dog,charliedog@marketo.com,Marketo
Easy,Fox,easyfox@marketo.com,Marketo

オプションで、lookupField、listId、partitionName のパラメーターをリクエストに含めることもできます。 lookupField 同期リードと同様に、重複排除する特定のフィールドを選択でき、デフォルトはメールです。 id を lookupField として指定して、「更新のみ」の操作を示すことができます。 listId では、静的リストを選択して、リードのリストを読み込むことができます。これにより、読み込みによる作成や更新に加えて、リスト内のリードがこの静的リストのメンバーになります。 partitionName インポート先の特定のパーティションを選択します。 詳しくは、ワークスペースとパーティションの節を参照してください。

呼び出しへの応答では、同期リードの場合のように成功または失敗のリストはなく、結果の配列のレコードの batchId と status フィールドがあることに注意してください。 これは、この API が非同期で、ステータスが Queued、Importing または Failed を返す場合があるためです。 インポートジョブのステータスを取得したり、完了時に失敗や警告を取得したりするには、batchId を保持する必要があります。 batchId は 7 日間有効です。