/contactimport/{importID}

目录 1 /contactimport/{importID} 2 URL 3 支持格式 4 HTTP 请求方式 5 认证方式 6 请求数限制 7 请求参数 8 请求字符串 9 返回结果 10 调用实例

/contactimport/{importID}

• 修改导入任务

URL

• {HOST}/services /contactimport/{importID}

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
importTaskId	是	String	导入任务ID

请求字符串

<?xml version="1.0" encoding="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <title>DJ测试创建导入任务_MOIDFY</title>
  <um:type>OnlyUpdateExists</um:type>
  <link href="http://services.unimarketing.com.cn/list/5158" rel="related"></link>
  <link href="http://services.unimarketing.com.cn/list/5158" rel="alternate"></link>
  <um:reportOpen>true</um:reportOpen>
  <um:reportEmail>unimail2011@163.com</um:reportEmail>
  <um:importMethod>api</um:importMethod>
  <um:status>building</um:status>
</entry> 
							

返回结果

<?xml version="1.0" encoding="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <id>http://services.unimarketing.com.cn/contactimport/6156</id>
  <title type="text">DJ测试创建导入任务_MOIDFY</title>
  <updated>2011-04-21T07:16:59.019Z</updated>
  <um:reportOpen>true</um:reportOpen>
  <um:reportEmail>unimail2011@163.com</um:reportEmail>
  <um:status>waiting</um:status>
  <um:total>3</um:total>
</entry>                              
                           

字段说明

名称	意义	数据类型	备注
id	导入任务ID	Number
title	导入任务名称	String
um:type	处理类型	String	UpdateExistsAddNew 更新已有的，添加新的联系人 OnlyAddNew仅添加新的联系人 OnlyUpdateExists仅更新已有的联系人 UnsubscribeExists退订已有的联系人 DeleteExists 删除已有的联系人
<link href="http://services.unimarketing.com.cn/list/{listID}" res="related"/>	添加到的列表ID	Number
<link href="http://services.unimarketing.com.cn/list/{listID}" res="alternate"/>	从列表中删除ID	Number
um:reportOpen	发送导入报告	布尔	true 发送导入报告 false 不发送导入报告 默认false;
um:reportEmail	导入报告通知邮件地址	String
um:total	导入任务联系人的总数	Number
um:status	导入任务的状态	String	building：创建中 waiting:等待中 queueing：排队中 exeucting：执行中 execute_succeed:导入成功 execute_failure：执行失败 execute_stop：执行任务取消

调用示例(Java 示例)

package cn.unisoftware.api.client.example.contact;

import org.apache.abdera.Abdera;
import org.apache.abdera.model.Entry;

import cn.unisoftware.api.client.ApiClient;
import cn.unisoftware.api.client.utils.AtomConstants;
import cn.unisoftware.api.client.utils.XmlUtil;

/**
 * 修改导入任务
 * @author DJ
 * @test 【true】
 */
public class ModifyImportTask {

	/**
	 * 系统不允许导入任务里没有导入数据的修改动作 
	 * @param args
	 * @throws Exception 
	 */
	public static void main(String[] args) throws Exception {
		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
		Abdera abdera = Abdera.getInstance();
		Entry entry = abdera.newEntry();
		entry.addExtension(AtomConstants.TITLE).setText("DJ测试创建导入任务_MOIDFY");

		entry.addExtension(AtomConstants.QName_UM_TYPE).setText("OnlyUpdateExists");

		String listID = "5158"; //列表ID
		entry.addLink("http://services.unimarketing.com.cn/list/"+listID).setRel(
				"related");
		entry.addLink("http://services.unimarketing.com.cn/list/"+listID).setRel(
				"alternate");
		entry.addExtension(AtomConstants.QNAME_UM_REPORTOPEN).setText("true");
		entry.addExtension(AtomConstants.QNAME_UM_REPORTEMAIL).setText("unimail2011@163.com"); //导入任务执行后导入任务报告发到那个邮箱
 
        String importID = "6156"; //导入任务ID
		
        XmlUtil.displayEncodeXml(entry);
        
        Entry res = apiClient.modifyImportTask(entry,importID);
        
        XmlUtil.displayEncodeXml(res);
        
	}

}