Markefanへのリードの高度なインポート

CSVファイルで作成したリードデータをMarkefanのリードリストにインポートします。 このAPIでは、doMergeCsvWithDb パラメータを指定したリードのインポートを行います。 もし既にリードが存在している場合、そのリードはCSVファイルの内容で更新されます。この場合、既に存在するリードIDは、ext_customer_id で指定します。

HTTP種類 : POST

URL : [BASE URL]/SpringRest/customer/advanced/import

HTTP戻り値 : JSON

パラメータ

名 前
必 須
access_token
String
True
list
File
True
userId
String
True
format
String
True
doMergeCsvWithDb
Boolean
True
format パラメータは以下のように指定します: format = name,email,gender,birthday,company_name,phone,department,role,industry,country_id,region,prefecture_id,muncipality_id,ext_customer_id
csv データファイルは以下のように指定します: ancil,[email protected],0,1990-03-01,ABC Inc,9876543210,IT,Engineers,情報通信業,日本,北海道地方,北海道,札幌市,10
gender(性別)は以下のように指定します:
0 – Male
1 – Female
2 – Other

JSON戻り値 例:

{
"code": 200,
"message": "save success",
"status": "200",
"generatedId": null,
"generatedIds": [
78
],
"statusObject": "OK",
"errorCode": null,
"errorLineNumber": null,
"errorFieldName": null,
"errorFieldValue": null,
"errorMessage": null
}

サンプルコード

このメソッドを使用するには、CSVファイルのパス、ユーザーID、フォーマットおよびアクセストークンを渡す必要があります。 ユーザーIDはloginAPIより取得します。フォーマットはCSVファイルのフォーマットと一致していなければなりません。 以下はこのメソッドの呼び出し例で、APIよりJSON戻り値を返します。
private String csvAdvancedImport(String accessToken , File csvFile, String userId, String format) {
try {
HttpClient client = new DefaultHttpClient();
HttpPost httpPost = new HttpPost("<API_BASE_URL>/SpringRest/customer/advanced/import");
HttpEntity entity = MultipartEntityBuilder.create().setMode(HttpMultipartMode.BROWSER_COMPATIBLE)
.addBinaryBody("list", csvFile).addTextBody("access_token", accessToken)
.addTextBody("userId", userId).addTextBody("format", format).addTextBody(“doMergeCsvWithDb”,true).build();
httpPost.setEntity(entity);
HTTP戻り値 response = client.execute(httpPost);
BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent()));
String line = "";
while ((line = rd.readLine()) != null) {
return line;
}
} catch (UnsupportedEncodingException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (ClientProtocolException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return null;
}

呼び出し方法

String Response = csvAdvancedImport(new File(98d9a7ea-8669-45e6-b141-f663c8cb35b8”, "/home/bquser/Downloads/cxm.csv"), "1","name,email,gender,birthday,company_name,phone,department,role,industry,country_id,region,prefecture_id,muncipality_id,ext_customer_id");