注意：以下文档只适用于TOP接口，请谨慎使用！

文档中心 > 阿里妈妈开放业务

创意接口

更新时间：2017/11/22 访问次数：826

一、创意绑定（taobao.zuanshi.banner.creative.bind）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
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）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
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）

  • 目前只支持本地图片上传制作创意
  • 创意名称要求：只支持汉字、字母、数字、下划线。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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）

  • 目前只支持本地图片修改
  • 创意修改，需要创意全量数据
  • 创意名称要求：只支持汉字、字母、数字、下划线。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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）

  • 目前只支持查询某个单元下绑定的创意
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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，查询出该单元下可以用来绑定的创意
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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
有用(0) 我要提问
返回
顶部

阿里巴巴集团|淘宝网|天猫|聚划算|全球速卖通|阿里巴巴国际交易市场|1688|阿里妈妈|阿里旅行 · 去啊|阿里云计算|YunOS|阿里通信|万网|高德|UC|友盟+

虾米|天天动听|来往|钉钉|支付宝

© 2009-2017 Aliyun.com 版权所有 ICP证：浙B2-20080101售前咨询 技术支持官方微博