/schedule/create

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

/schedule/create

• 创建发送任务

URL

• {HOST}/services /schedule/create

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
title	发送任务名称	字符串
um:subject	邮件主题	字符串	需要将“<”转义为& lt; “>”转义为& gt;
um:from	发送人姓名与邮件地址	字符串	格式 xxx< yyy@163.com >
um:from	发送人姓名与邮件地址	字符串
um:reply	回复地址	字符串
um:triggerMethod	触发方式	字符串	time：时间触发
um:triggerCondition	发送条件	字符串	Immediately：立即发送(如是立即发送，不需要发送时间)
um:startupTime	发送时间	字符串	格式:yyyy-MM-dd HH:mm:ss
um:optimizePolicy	启用邮件主题优化策略	字符串	auto：启用自动优化策略
um:analyticsPolicy	是否生成Google分析跟踪	字符串	GA(OnlyGenerateTrackingURLs)： 启用Google分析仅在邮件中生成跟踪链接； GA(BuiltinAccount)： 集成系统内置Google分析帐户数据及在邮件中生成跟踪链接； GA(AuthenticatedAccount)： 用户授权系统获取其Google分析帐户数据并在邮件中生成跟踪链接
um:domainScope	跟踪链接的域名	字符串	指定邮件中链接的跟踪域名
um:sendType	发送类型（发送系统系统邮件）	字符串	normal计划邮件(缺省值) system系统邮件（只能发送一封） trigger 触发邮件（暂不实现）, 可以发送多封，触发条件通过联系人细分实现，这里可以传递细分id 触发的联系人和细分的id只能有一个，避免发送重复的邮件。
<link href=" http://www.unimarketing.com.cn/contact/{email}" rel="alternate" />	email 系统邮件的收件人	字符串

请求字符串

<?xml version="1.0" encoding="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <title>DJ_MY_GOD_OOK</title>
  <um:subject>2010年8月编程书刊</um:subject>
  <um:from>DJ&lt;unimail2012@163.com&gt;</um:from>
  <um:reply>unimail2012@163.com</um:reply>
  <um:triggerMethod>time</um:triggerMethod>
  <um:startupTime>2011-05-16 17:14:24</um:startupTime>
  <um:optimizePolicy>auto</um:optimizePolicy>
  <um:analyticsPolicy>GA(OnlyGenerateTrackingURLs)</um:analyticsPolicy>
  <um:domainScope>http://beijing.piaowu.com.cn</um:domainScope>
  <um:domainScope>http://tianjing.piaowu.com.cn</um:domainScope>
  <link href="http://services.unimarketing.com.cn/message/9989" rel="related"></link>
  <link href="http://services.unimarketing.com.cn/list/5072" rel="related"></link>
  <link href="http://services.unimarketing.com.cn/list/5093" rel="related"></link>
  <um:sendType>normal</um:sendType>
  <link href="http://127.0.0.1:8080/uniapi/services/contact/unimail2012@163.com" rel="alternate"></link>
</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/schedule/7112</id>
  <title type="text">DJ_MY_GOD_OOK</title>
  <um:messageName>我的测试DJ</um:messageName>
  <um:startupTime>2011-05-16 17:14:24</um:startupTime>
</entry>
                                 
                           

字段说明

字段名称	意义	数据类型	备注
id	发送计划ID	Number
title	发送计划名称	String
um:messageName	邮件名称	String
um:startupTime	开始发送时间	String

调用示例(Java 示例)

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

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
 *
 */
public class CreateSendTask {


	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_MY_GOD_OOK");
		entry.addExtension(AtomConstants.QName_UM_SUBJECT).setText("2010年8月编程书刊");
		entry.addExtension(AtomConstants.QName_UM_FROM).setText("DJ<unimail2012
							@163.com>");
		
		entry.addExtension(AtomConstants.QName_UM_REPLY).setText("unimail2012@163.com");
		entry.addExtension(AtomConstants.QName_UM_TRIGGERMETHOD).setText("time");
//		entry.addExtension(AtomConstants.QName_UM_TRIGGERCONDITION).setText("immediately"); //立即发送，如果是立即发送就不需要发送时间
		entry.addExtension(AtomConstants.QName_UM_STARTUPTIME).setText("2011-05-16 17:14:24");
		entry.addExtension(AtomConstants.QNAME_UM_OPTIMIZEPOLICY).setText("auto");
		
		entry.addExtension(AtomConstants.QName_UM_ANALYTICSPOLICY).setText("GA(OnlyGenerateTrackingURLs)");
		entry.addExtension(AtomConstants.QName_UM_DOMAINSCOPE).setText("http://beijing.piaowu.com.cn");
		entry.addExtension(AtomConstants.QName_UM_DOMAINSCOPE).setText("http://tianjing.piaowu.com.cn");
		/**
		 * 需要发送的邮件
		 */
		entry.addLink("http://services.unimarketing.com.cn/message/9989").setAttributeValue("rel", "related");
		
		/**
		 * 表示需要跟那个邮件列表用户发送
		 */
		entry.addLink("http://services.unimarketing.com.cn/list/5072").setAttributeValue("rel", "related");
		entry.addLink("http://services.unimarketing.com.cn/list/5093").setAttributeValue("rel", "related");
//		entry.addExtension(AtomConstants.QNAME_UM_SENDTYPE).setText("system"); //系统邮件
		entry.addExtension(AtomConstants.QNAME_UM_SENDTYPE).setText("normal"); //计算邮件
		/**
		 * 需要单独发送的Email
		 */
//		entry.addLink("http://www.unimarketing.com.cn/contact/beipiao83@163.com").setAttributeValue("rel", "alternate");
		entry.addLink("http://127.0.0.1:8080/uniapi/services/contact/unimail2012@163.com").setAttributeValue("rel", "alternate");
       
		XmlUtil.displayEncodeXml(entry);
		
		Entry res = apiClient.createSendTask(entry);
		XmlUtil.displayEncodeXml(res);
	}
}