一、创意绑定（taobao.zuanshi.banner.creative.bind）
ZuanshiBannerCreativeBindRequest request = new ZuanshiBannerCreativeBindRequest();
ZuanshiBannerCreativeBindResponse response = null;
try {
// 计划ID
request.setCampaignId(227248001l);
// 单元ID
request.setAdgroupId(227248002l);
// 需要绑定的创意ID，多个逗号连接
request.setCreativeIdList("225640080001");
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response);
}
return response.getSubMsg();
二、创意解绑（taobao.zuanshi.banner.creative.unbind）
ZuanshiBannerCreativeUnbindRequest request = new ZuanshiBannerCreativeUnbindRequest();
ZuanshiBannerCreativeUnbindResponse response = null;
try {
// 计划ID
request.setCampaignId(227248001l);
// 单元ID
request.setAdgroupId(227248002l);
// 需要解绑的创意ID，多个逗号连接
request.setCreativeIdList("225640080001");
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response);
}
return response.getSubMsg();
三、创意创建（taobao.zuanshi.banner.creative.create）
- 目前只支持本地图片上传制作创意
- 创意名称要求：只支持汉字、字母、数字、下划线。
ZuanshiBannerCreativeCreateRequest request = new ZuanshiBannerCreativeCreateRequest();
ZuanshiBannerCreativeCreateResponse response = null;
request.setName("top正在需改名称"); //创意名称
request.setCatId(3l); //类目ID
//点击链接
request.setClickUrl("https://detail.tmall.com/item.htm?spm=608.7065813.ne.1.Jai6Hw&id=522068822626&tracelog=jubuybigpic&sku_properties=122216927:77835123");
//是否pc链接转无线链接
request.setIsTransToWifi(true);
//本地图片地址
request.setImage(new FileItem("D:\\创意图片\\300x250_lz.jpg"));
try {
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response.getResult());
}
return response.getSubMsg();
四、创意修改（taobao.zuanshi.banner.creative.modify）
- 目前只支持本地图片修改
- 创意修改，需要创意全量数据
- 创意名称要求：只支持汉字、字母、数字、下划线。
ZuanshiBannerCreativeModifyRequest request = new ZuanshiBannerCreativeModifyRequest();
ZuanshiBannerCreativeModifyResponse response = null;
request.setId(id); //创意ID
request.setName("top正在需改名称_new"); //创意名称
request.setCatId(3l); //类目ID
//点击链接
request.setClickUrl("https://detail.tmall.com/item.htm?spm=608.7065813.ne.1.Jai6Hw&id=522068822626&tracelog=jubuybigpic&sku_properties=122216927:77835123");
//是否pc链接转无线链接
request.setIsTransToWifi(true);
//图片地址
request.setImage(new FileItem("D:\\创意图片\\300x250_new.jpg"));
try {
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response.getResult());
}
return response.getSubMsg();
五、已绑定创意查询（taobao.zuanshi.banner.creative.find.bind）
ZuanshiBannerCreativeFindBindRequest request = new ZuanshiBannerCreativeFindBindRequest();
ZuanshiBannerCreativeFindBindResponse response = null;
try {
//计划ID
request.setCampaignId(223367576l);
//单元ID
request.setAdgroupId(223950504l);
//创意等级
request.setCreativeLevel(1l);
//创意尺寸，多个尺寸逗号连接
request.setSizeList("520x280");
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response.getResult());
}
return response.getSubMsg();
六、创意查询（taobao.zuanshi.banner.creative.find）
- 不传入单元ID和计划ID，查询出用户所有创意
- 传入单元ID和计划ID，查询出该单元下可以用来绑定的创意
ZuanshiBannerCreativeFindRequest request = new ZuanshiBannerCreativeFindRequest();
ZuanshiBannerCreativeFindResponse response = null;
try {
//计划ID
request.setCampaignId(227248001l);
//单元ID
request.setAdgroupId(227248002l);
//创意尺寸，多个尺寸逗号连接
request.setSizeList("400x300");
//审核状态，多个状态逗号连接
request.setAuditStatusList("1");
response = client.execute(request, sessionKey);
} catch (ApiException e) {
e.printStackTrace();
}
if (response.isSuccess()) {
return JSONUtils.toJsonPrettyPrinting(response.getResult());
}
return response.getSubMsg();
七、创意相关码表数据
创意尺寸，200x300 => width：200 , height:300
类目码表
| 类目名称 |
类目编码 |
| 女装 |
1 |
| 彩妆，护肤 |
2 |
| 女鞋 |
3 |
| 男装 |
4 |
| 男鞋 |
5 |
| 箱包 |
6 |
| 食品，茶叶，烟酒 |
7 |
| 内衣 |
8 |
| 保健 |
9 |
| 饰品，服饰 |
10 |
| 运动 |
11 |
| 居家 |
12 |
| 童装，母婴 |
13 |
| 电器 |
14 |
| 数码 |
15 |
| 游戏 |
16 |
| 团购 |
17 |
| 其他 |
18 |
创意审核状态主要包含待审核（【-4】，【-1】和【0】），审核通过（【1】）以及审核拒绝（【-2】，【-5】和【-9】）
| 状态 |
状态值 |
| 待审核 |
-4,-1,0 |
| 审核通过 |
1 |
| 审核拒绝 |
-2,-5,-9 |
创意格式码表
| 格式名称 |
格式值 |
| 图片创意 |
2 |
| Flash创意 |
3 |
| 视频创意 |
4 |
| 文字链创意 |
5 |
| Flash不遮盖创意 |
9 |
| 模板创意 |
10 |
创意等级编码，待审核的创意未分等级【99】
| 等级名称 |
等级值 |
| 一级 |
1 |
| 二级 |
2 |
| 三级 |
3 |
| 四级 |
4 |
| 十级 |
10 |
| 未分等级 |
99 |
FAQ
关于此文档暂时还没有FAQ
