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

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

创意库创意部分编辑

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
creative_command_list_v_o CreativeCommandListVO 必须 creativeCommandListVO
  • creative_list
  • CreativeCommandVO []
  • 必须
  • 创建创意实体集合
  • └ 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:否

响应参数

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

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCreativeUpdatepartRequest req = new UniversalbpNewCreativeUpdatepartRequest();
UniversalbpNewCreativeUpdatepartRequest.TopServiceContext obj1 = new UniversalbpNewCreativeUpdatepartRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCreativeUpdatepartRequest.CreativeCommandListVO obj2 = new UniversalbpNewCreativeUpdatepartRequest.CreativeCommandListVO();
List<UniversalbpNewCreativeUpdatepartRequest.CreativeCommandVO> list4 = new ArrayList<UniversalbpNewCreativeUpdatepartRequest.CreativeCommandVO>();
UniversalbpNewCreativeUpdatepartRequest.CreativeCommandVO obj5 = new UniversalbpNewCreativeUpdatepartRequest.CreativeCommandVO();
list4.add(obj5);
obj5.setCreativeId(6843262308L);
obj5.setCreativeName("sss");
obj5.setSource(1L);
obj5.setTpFormat(2L);
obj5.setStartTime("2023-05-29 18:00:00");
obj5.setEndTime("2024-05-28 17:59:00");
obj5.setTitle("薄荷脑软膏,测试请不要拍");
obj5.setImagePath("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj5.setClickUrl("https://a.m.taobao.com/i679056995041.htm");
obj5.setVideoId(398436114008L);
obj5.setCreativeProtection(1L);
obj5.setVideoDuration("10");
obj5.setVideoPath("https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4");
obj5.setVideoImagePath("https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg");
List<UniversalbpNewCreativeUpdatepartRequest.ItemMaterialVO> list8 = new ArrayList<UniversalbpNewCreativeUpdatepartRequest.ItemMaterialVO>();
UniversalbpNewCreativeUpdatepartRequest.ItemMaterialVO obj9 = new UniversalbpNewCreativeUpdatepartRequest.ItemMaterialVO();
list8.add(obj9);
obj9.setMaterialId(714616513841L);
obj9.setVideoId(398436114008L);
obj9.setSource(1L);
obj9.setHaitangId(989898L);
obj9.setFormatType(1L);
obj9.setUrl("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj9.setCoverUrl("https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png");
list6.setMaterialList(list8);
obj5.setCreativeSize("513x750");
UniversalbpNewCreativeUpdatepartRequest.CreativePromotionEntityVO obj11 = new UniversalbpNewCreativeUpdatepartRequest.CreativePromotionEntityVO();
obj11.setPromotionType("item");
obj11.setSubPromotionType("item");
obj11.setPromotionEntityId(714616513841L);
UniversalbpNewCreativeUpdatepartRequest.PromotionMaterialInfoVO obj12 = new UniversalbpNewCreativeUpdatepartRequest.PromotionMaterialInfoVO();
obj12.setMaterialId(714616513841L);
obj12.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj12.setLinkUrl("http://item.taobao.com/item.htm?id=715121254343");
obj12.setMaterialName("yiliantest测试请不要拍22");
obj12.setTitle("yiliantest测试请不要拍22");
obj11.setMaterial(obj12);
list10.setCreativePromotionEntity(obj11);
obj5.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\"
        }");
obj5.setJsInHtml("https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html");
obj5.setOuterId(225349579L);
obj5.setCreativeCenterId("225349579");
obj5.setItemIdList(new Long[] { 679056995041 };
);
obj5.setClickurlMediaTypeList("1");
obj5.setTabType("2");
obj5.setTemplateId(2000000000L);
obj5.setAdgroupId(68793666608L);
obj5.setIsClip(false);
obj2.setCreativeList(list4);
req.setCreativeCommandListVO(obj2);
UniversalbpNewCreativeUpdatepartResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_creative_updatepart_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <top_bulk_data>
            <count>10</count>
            <data_list>
                <number>5</number>
                <number>3</number>
            </data_list>
        </top_bulk_data>
    </top_result>
</universalbp_new_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

返回
顶部