文档中心 > API类目 > 万相台无界API

taobao.universalbp.creative.updatepart (创意库创意部分编辑)

创意库创意部分编辑

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
data_list CreativeCommandVo 必须 list
  • └ creative_id
  • Number
  • 可选
  • 6843262308
  • 创意id
  • └ creative_name
  • String
  • 可选
  • sss
  • 创意名称
  • └ source
  • Number
  • 可选
  • 1
  • 创意来源,1:本地上传,3:CreativeCenter
  • └ tp_format
  • Number
  • 可选
  • 2
  • 创意格式,2:图片,10:创意模板,12:微视频
  • └ start_time
  • String
  • 可选
  • 2023-05-29 18:00:00
  • 创意开始时间,用户设置
  • └ end_time
  • String
  • 可选
  • 2024-05-28 17:59:00
  • 创意结束时间,用户设置
  • └ title
  • String
  • 可选
  • 薄荷脑软膏,测试请不要拍
  • 推广标题
  • └ image_path
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
  • 一跳地址
  • └ click_url
  • String
  • 可选
  • https://a.m.taobao.com/i679056995041.htm
  • 二跳地址
  • └ video_id
  • Number
  • 可选
  • 398436114008
  • 视频id
  • └ creative_protection
  • Number
  • 可选
  • 1
  • 视频保护,0-关闭,1-开启
  • └ video_duration
  • String
  • 可选
  • 10
  • 视频时长
  • └ video_path
  • String
  • 可选
  • https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4
  • 视频地址
  • └ video_image_path
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg
  • 视频封面地址
  • material_list
  • ItemMaterialVo []
  • 可选
  • 单品创意素材
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ video_id
  • Number
  • 可选
  • 398436114008
  • 视频id
  • └ source
  • Number
  • 可选
  • 1
  • 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意
  • └ haitang_id
  • Number
  • 可选
  • 989898
  • 对应的海棠id
  • └ format_type
  • Number
  • 可选
  • 1
  • 格式类型,1:图片,2:抄底文案,3:产品词,4:属性词,5:链接,51:淘积木URL,6:文案,7:长图,8:短文本,9:长文本,10:LOGO,11:视频,12:底图,13:tag,14:智能文案,15:促销词,16:标签词,17:优惠券,18:原价,19:折扣价,20:智能标题候选词,21:宝贝图 包括主图 长图 副图,22:宝贝标题,23:智能图,24:美观图,32:短标题,33:算法产出,仅供审核用图,34:淘宝素材中心图片,35:店铺名称,36:商品SKU图,37:商品详情页图,38:创意图,39:算法加工后的直播间封面图,40:算法加工后的直播间宝贝图,41:算法加工后的直播间宝贝标题文案,42:长图3:4,44:创意样式,45:主搜商品卡片轮播图,46:主搜商品3比4图,47:图标图片,48:二跳短视频,101:用户主标题,102:用户副标题,103:用户标题3,25:长图微视频,26:方图微视频,27:审核通过后原图做成的ppt视频,28:账号头像,29:素材组下非审核素材内容,主要传递数据用,30:鹿班商品图,31:算法剪辑视频,60:创意中心打包的图(只有外审使用),50:视频ID素材,124:自动审核通过,125:仅合理性审核的图片,126:仅合理性审核的文案
  • └ url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
  • url
  • └ cover_url
  • String
  • 可选
  • https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
  • 封面url
  • └ creative_size
  • String
  • 可选
  • 513x750
  • 创意尺寸
  • creative_promotion_entity
  • CreativePromotionEntityVo
  • 可选
  • 推广主体
  • └ promotion_type
  • String
  • 可选
  • item
  • 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义;
  • └ sub_promotion_type
  • String
  • 可选
  • item
  • 推广子主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,you_hao_huo:有好货,picture:图文,short_video:短视频,live_room:直播间,live_spot:看点,tao_blocks:淘积木,user_define_url:自定义url
  • └ promotion_entity_id
  • Number
  • 可选
  • 714616513841
  • 推广主体id
  • material
  • PromotionMaterialInfoVo
  • 可选
  • 主体物料信息
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ img_url
  • String
  • 可选
  • //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
  • 图片地址
  • └ link_url
  • String
  • 可选
  • http://item.taobao.com/item.htm?id=715121254343
  • 跳转链接
  • └ material_name
  • String
  • 可选
  • yiliantest测试请不要拍22
  • 物料名称
  • └ title
  • String
  • 可选
  • yiliantest测试请不要拍22
  • 标题
  • └ template_data
  • String
  • 可选
  • { "_creationType": { "selectedOption": "video" }, "_apng": "https://a1.alicdn.com/assets/%E6%B4%BB%E5%8A%A8%E4%BF%83%E9%94%80%E5%80%BE%E5%90%91/%E6%B5%81%E6%98%9F%E9%9B%A8.png", "image": "https://img.alicdn.com/imgextra/i2/2247603103/O1CN01cHB4B71YnDo0G1MBV_!!2247603103-0-alimamacc.jpg" }
  • 从海棠获取的templateData
  • └ js_in_html
  • String
  • 可选
  • https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
  • 从海棠获取的地址
  • └ outer_id
  • Number
  • 可选
  • 225349579
  • 外部实体id,eg:前端创意中心id
  • └ creative_center_id
  • String
  • 可选
  • 225349579
  • 前端创意中心id
  • └ item_id_list
  • Number []
  • 可选
  • [679056995041]
  • 创意关联宝贝
  • └ clickurl_media_type_list
  • String []
  • 可选
  • [1]
  • 跳转地址媒体类型,1:PC,2:无线,3:PC和无线
  • └ tab_type
  • String
  • 可选
  • 2
  • tab类型,
  • └ template_id
  • Number
  • 可选
  • 2000000000
  • 创意模板ID,
  • └ adgroup_id
  • Number
  • 可选
  • 68793666608
  • 单元id
  • └ is_clip
  • Boolean
  • 可选
  • false
  • 是否裁剪过,true:是,false:否

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • top_bulk_data
  • TopBulkData
  • 结果集
  • └ data_list
  • Number []
  • 5,3
  • 批量结果集
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCreativeUpdatepartRequest req = new UniversalbpCreativeUpdatepartRequest();
UniversalbpCreativeUpdatepartRequest.TopServiceContext obj1 = new UniversalbpCreativeUpdatepartRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCreativeUpdatepartRequest.CreativeCommandVo obj2 = new UniversalbpCreativeUpdatepartRequest.CreativeCommandVo();
obj2.setCreativeId(6843262308L);
obj2.setCreativeName("sss");
obj2.setSource(1L);
obj2.setTpFormat(2L);
obj2.setStartTime("2023-05-29 18:00:00");
obj2.setEndTime("2024-05-28 17:59:00");
obj2.setTitle("薄荷脑软膏,测试请不要拍");
obj2.setImagePath("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj2.setClickUrl("https://a.m.taobao.com/i679056995041.htm");
obj2.setVideoId(398436114008L);
obj2.setCreativeProtection(1L);
obj2.setVideoDuration("10");
obj2.setVideoPath("https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4");
obj2.setVideoImagePath("https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg");
List<UniversalbpCreativeUpdatepartRequest.ItemMaterialVo> list4 = new ArrayList<UniversalbpCreativeUpdatepartRequest.ItemMaterialVo>();
UniversalbpCreativeUpdatepartRequest.ItemMaterialVo obj5 = new UniversalbpCreativeUpdatepartRequest.ItemMaterialVo();
list4.add(obj5);
obj5.setMaterialId(714616513841L);
obj5.setVideoId(398436114008L);
obj5.setSource(1L);
obj5.setHaitangId(989898L);
obj5.setFormatType(1L);
obj5.setUrl("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj5.setCoverUrl("https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png");
obj2.setMaterialList(list4);
obj2.setCreativeSize("513x750");
UniversalbpCreativeUpdatepartRequest.CreativePromotionEntityVo obj6 = new UniversalbpCreativeUpdatepartRequest.CreativePromotionEntityVo();
obj6.setPromotionType("item");
obj6.setSubPromotionType("item");
obj6.setPromotionEntityId(714616513841L);
UniversalbpCreativeUpdatepartRequest.PromotionMaterialInfoVo obj7 = new UniversalbpCreativeUpdatepartRequest.PromotionMaterialInfoVo();
obj7.setMaterialId(714616513841L);
obj7.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj7.setLinkUrl("http://item.taobao.com/item.htm?id=715121254343");
obj7.setMaterialName("yiliantest测试请不要拍22");
obj7.setTitle("yiliantest测试请不要拍22");
obj6.setMaterial(obj7);
obj2.setCreativePromotionEntity(obj6);
obj2.setTemplateData("{
          \"_creationType\": {
            \"selectedOption\": \"video\"
          },
          \"_apng\": \"https://a1.alicdn.com/assets/%E6%B4%BB%E5%8A%A8%E4%BF%83%E9%94%80%E5%80%BE%E5%90%91/%E6%B5%81%E6%98%9F%E9%9B%A8.png\",
          \"image\": \"https://img.alicdn.com/imgextra/i2/2247603103/O1CN01cHB4B71YnDo0G1MBV_!!2247603103-0-alimamacc.jpg\"
        }");
obj2.setJsInHtml("https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html");
obj2.setOuterId(225349579L);
obj2.setCreativeCenterId("225349579");
obj2.setItemIdList(new Long[] { 679056995041 };
);
obj2.setClickurlMediaTypeList("1");
obj2.setTabType("2");
obj2.setTemplateId(2000000000L);
obj2.setAdgroupId(68793666608L);
obj2.setIsClip(false);
req.setDataList(obj2);
UniversalbpCreativeUpdatepartResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_creative_updatepart_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <top_bulk_data>
            <data_list>
                <number>5</number>
                <number>3</number>
            </data_list>
            <count>1</count>
        </top_bulk_data>
    </result>
</universalbp_creative_updatepart_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部