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

taobao.universalbp.new.creative.preview (预览创意)

预览创意

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
creative_preview_query_v_o CreativePreviewQueryVO 必须 creativePreviewQueryVO
  • adzone_list
  • AdzoneVO []
  • 可选
  • 已选资源位
  • └ adzone_id
  • Number
  • 可选
  • 111287850198
  • 资源包id
  • └ adzone_name
  • String
  • 可选
  • 全屏微详情
  • 资源包名字
  • └ description
  • String
  • 可选
  • 首页及购中后的全屏微详情场景
  • 描述
  • └ img_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png
  • 预览图片地址
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • creative
  • CreativeVO
  • 可选
  • 所选创意
  • └ creative_id
  • Number
  • 可选
  • 6843262308
  • 创意id
  • └ creative_name
  • String
  • 可选
  • sss
  • 创意名称
  • └ creative_type
  • Number
  • 可选
  • 1
  • 创意分类,1:静态创意,2:智能创意,3:PSD创意,4:动态文案创意,5:自动化创意,6:智能创意,7:综合静态创意,8:综合智能创意,9:自动直播创意,10:元素化创意,11:素材类创意,12:钻展多图创意
  • └ source
  • Number
  • 可选
  • 1
  • 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意
  • └ creative_center_id
  • String
  • 可选
  • 225349579
  • 前端创意中心id
  • └ tp_format
  • Number
  • 可选
  • 2
  • 创意格式,1:文字,2:图片,3:Flash,4:视频,5:文字链,9:FLASH不遮盖,10:创意模板,11:视频直播,12:微视频,203:智能创意-三图创意
  • 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
  • └ template_id
  • Number
  • 可选
  • 2000000000
  • 创意模板ID,
  • └ outer_id
  • Number
  • 可选
  • 225349579
  • 外部实体id,eg:前端创意中心id
  • └ js_in_html
  • String
  • 可选
  • https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
  • 从海棠获取的地址
  • └ 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
  • └ clickurl_media_type_list
  • String []
  • 可选
  • [1]
  • 跳转地址媒体类型,1:PC,2:无线,3:PC和无线
  • audit
  • AuditVO
  • 可选
  • 审核信息
  • └ status
  • String
  • 可选
  • W
  • 状态,PW:待送审,W:待审核,P:审核通过,R:审核拒绝,AW:合成中,AP:合成通过,AR:合成失败,T:排查中,PP:部分通过,E:创意过期,A:创意故障
  • └ audit_status
  • Number
  • 可选
  • 2
  • 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed
  • └ effective_time
  • String
  • 可选
  • 2023-05-29 18:21:40
  • 生效时间
  • └ expire_time
  • String
  • 可选
  • 2999-12-31 23:59:59
  • 创意过期时间
  • └ audit_reason
  • String
  • 可选
  • 直播已结束,结束后创意自动变为审核拒绝状态
  • 审核原因
  • adzone_audit_result_list
  • AuditVO []
  • 可选
  • 审核信息
  • └ status
  • String
  • 可选
  • W
  • 状态,PW:待送审,W:待审核,P:审核通过,R:审核拒绝,AW:合成中,AP:合成通过,AR:合成失败,T:排查中,PP:部分通过,E:创意过期,A:创意故障
  • └ audit_status
  • Number
  • 可选
  • 2
  • 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed
  • └ effective_time
  • String
  • 可选
  • 2023-05-29 18:21:40
  • 生效时间
  • └ expire_time
  • String
  • 可选
  • 2999-12-31 23:59:59
  • 创意过期时间
  • └ audit_reason
  • String
  • 可选
  • 直播已结束,结束后创意自动变为审核拒绝状态
  • 审核原因
  • preview_list
  • CreativeAdzonePreviewVO []
  • 可选
  • 创意预览信息
  • └ adzone_type
  • Number
  • 可选
  • 1
  • 资源位类型,1:首焦,2:猜你喜欢,3:NewDetail
  • └ adzone_name
  • String
  • 可选
  • 全屏微详情
  • 资源包名字
  • └ adzone_id
  • Number
  • 可选
  • 111287850198
  • 资源包id
  • preview_data_list
  • CreativePreviewResultVO []
  • 可选
  • 创意预览返回前端展示对象
  • └ preview_format
  • Number
  • 可选
  • 2
  • 预览创意类型,2:图片,10:创意模板,12:微视频
  • └ preview_img_url
  • String
  • 可选
  • https://kb-render.chuangyi.taobao.com/template/93214.html?data=%7B%22image%22%3A%22https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi2%2F2247603103%2FO1CN011YnDptRlLOusjIj_%21%212247603103-0-alimamacc.jpg%22%2C%22video_duration%22%3A6%2C%22buyInfo%22%3A%220%E4%BA%BA%E4%BB%98%E6%AC%BE%22%2C%22price%22%3A110.00%2C%22video%22%3A%22https%3A%2F%2Fcloud.video.taobao.com%2Fplay%2Fu%2F2%2C247%2C603%2C103%2Fp%2F2%2Fe%2F6%2Ft%2F1%2F412128529977.mp4%3FsBizCode%3Dalimama_tuijian.mp4%22%2C%22title%22%3A%22%E4%B8%BB%E5%9B%BE%E8%A7%86%E9%A2%91%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%E7%8C%AB%E7%B2%AE%E5%B9%BC%E7%8C%AB%E5%A5%B6%E7%B3%95%E7%8C%AB%E4%B8%BB%E7%B2%AE%22%7D
  • 预览创意图片地址
  • └ preview_click_url
  • String
  • 可选
  • https://a.m.taobao.com/i678729730773.htm
  • 预览落地页地址
  • └ preview_size
  • String
  • 可选
  • 342x530
  • 预览创意尺寸
  • └ preview_scale
  • String
  • 可选
  • 0.5
  • 预览创意尺寸
  • └ preview_video_path
  • String
  • 可选
  • 342x530
  • 视频地址
  • └ preview_video_image
  • String
  • 可选
  • 342x530
  • 视频封面
  • └ creative_size
  • String
  • 可选
  • 513x750
  • 创意尺寸
  • item_videos
  • ItemVideoVO []
  • 可选
  • 单品创意视频
  • └ cover_url
  • String
  • 可选
  • https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
  • 封面url
  • └ poster
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg
  • 封面url(海棠)
  • └ item_id
  • Number
  • 可选
  • 708275631127
  • 商品
  • └ video_url
  • String
  • 可选
  • https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4
  • 视频url
  • └ audit_state
  • Number
  • 可选
  • 1
  • 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed
  • └ audit_desc
  • String
  • 可选
  • xxxxx
  • 审核描述
  • └ video_id
  • Number
  • 可选
  • 415780011227
  • 视频id
  • └ source
  • Number
  • 可选
  • 1
  • 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意
  • └ 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:仅合理性审核的文案
  • └ width
  • Number
  • 可选
  • 800
  • 视频宽度
  • └ height
  • Number
  • 可选
  • 1200
  • 视频高度
  • └ duration
  • Number
  • 可选
  • 32
  • 视频时长
  • └ haitang_id
  • Number
  • 可选
  • 989898
  • 对应的海棠id
  • └ online_status
  • Number
  • 可选
  • 1
  • 创意状态,1:ON,-1:ARCHIVE
  • └ start_time
  • String
  • 可选
  • 2023-05-29 18:00:00
  • 创意开始时间,用户设置
  • └ end_time
  • String
  • 可选
  • 2024-05-28 17:59:00
  • 创意结束时间,用户设置
  • └ create_time
  • String
  • 可选
  • 2023-05-29 18:21:40
  • 创建时间
  • └ update_time
  • String
  • 可选
  • 2023-05-29 18:21:40
  • 更新时间
  • 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
  • 标题
  • └ extend_data
  • String
  • 可选
  • https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
  • 扩展数据
  • material_image_info
  • MaterialImageInfoVO
  • 可选
  • 物料图片信息
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ image_position
  • Number
  • 可选
  • 0
  • 主副图图片位置,主图0,副图从1开始
  • └ img_url
  • String
  • 可选
  • https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
  • 图片链接
  • └ link_url
  • String
  • 可选
  • http://item.taobao.com/item.htm?id=668800719012
  • 物料链接
  • └ material_name
  • String
  • 可选
  • 外投宝贝测试,请不要拍
  • 物料名称
  • └ 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
  • └ 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
  • 视频封面地址
  • └ item_id_list
  • Number []
  • 可选
  • [679056995041]
  • 创意关联宝贝
  • children
  • CreativeChildrenVO []
  • 可选
  • 关键词推广素材
  • 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
  • └ tab_type
  • String
  • 可选
  • 103
  • tab类型,101:竖版大图800x1200,102:竖版视频800x1200,103:竖版长图513x750,104:竖版视频512x750,105:竖版模板513x750,113:方图800x800,114:方视频800x800,115:横版大图320x90,116:横版大图240x100,117:横版大图140x120,118:横版大图730x350,119:横版大图846x220,120:横版大图780x210,121:横版大图840x90,122:横版大图180x100,124:横版大图980x200,125:横版大图820x90,126:竖版视频750x1000,127:竖版视频720x960,128:竖版视频1080x1440,129:竖版视频720x1280,130:竖版视频1080x1920
  • └ tab_type_name
  • String
  • 可选
  • 103
  • tab类型名称,101:竖版大图800x1200,102:竖版视频800x1200,103:竖版长图513x750,104:竖版视频512x750,105:竖版模板513x750,113:方图800x800,114:方视频800x800,115:横版大图320x90,116:横版大图240x100,117:横版大图140x120,118:横版大图730x350,119:横版大图846x220,120:横版大图780x210,121:横版大图840x90,122:横版大图180x100,124:横版大图980x200,125:横版大图820x90,126:竖版视频750x1000,127:竖版视频720x960,128:竖版视频1080x1440,129:竖版视频720x1280,130:竖版视频1080x1920
  • └ type_name
  • String
  • 可选
  • 自定义创意
  • 创意类型名称,1:自定义创意,1:主副图创意,1:主图视频创意,5:智能创意
  • └ type
  • String
  • 可选
  • 1
  • 创意类型名称,1:自定义创意,1:主副图创意,1:主图视频创意,5:智能创意
  • └ main_pic_video
  • String
  • 可选
  • 1
  • 创意是否为主图视频创意,异步创建,1:是,其他不是
  • └ report_info_map
  • String
  • 可选
  • 报表数据
  • └ adgroup_id
  • Number
  • 可选
  • 68796878061
  • 单元id
  • material_image_info
  • MaterialImageInfoVO
  • 可选
  • 主副图素材
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ image_position
  • Number
  • 可选
  • 0
  • 主副图图片位置,主图0,副图从1开始
  • └ img_url
  • String
  • 可选
  • https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
  • 图片链接
  • └ link_url
  • String
  • 可选
  • http://item.taobao.com/item.htm?id=668800719012
  • 物料链接
  • └ material_name
  • String
  • 可选
  • 外投宝贝测试,请不要拍
  • 物料名称
  • material_info
  • CommonMaterialVO
  • 可选
  • 通用主体VO
  • 物料信息
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ material_type
  • Number
  • 可选
  • 1
  • 物料类型,1:淘宝宝贝,2:淘宝店铺,3:cms LandingPage页面,4:cms 分流总页面,5:自定义,201:PC店铺LandingPage页面,202:无线店铺LandingPage页面,203:内容LandingPage页面,204:淘宝直播,210:淘宝直播用户ID,205:有好货,209:无线店铺Tab3页面,212:超级品牌日LandingPage页面,211:超级发布会LandingPage页面,301:ICBU商品,302:ICBU PC店铺LandingPage页面,303:ICBU PC店铺,8:用户ID,9:信息流淘积木用户ID,10:口碑用户ID,206:店铺优惠券,207:商品优惠券,208:直播单品,309:直播间商品半屏卡,304:1688商品,305:内容平台-短视频,306:附近门店-用户ID,307:饿了么-菜品,401:LAZADA商品,501:飞猪酒店,502:飞猪商品,503:飞猪短信,601:淘积木页面,1001:AE宝贝,1101:淘宝宝贝SKU,310:内容平台-订阅内容
  • └ material_name
  • String
  • 可选
  • yiliantest测试请不要拍22
  • 物料名称
  • └ title
  • String
  • 可选
  • yiliantest测试请不要拍22
  • 标题
  • └ img_url
  • String
  • 可选
  • //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
  • 图片地址
  • └ link_url
  • String
  • 可选
  • http://item.taobao.com/item.htm?id=715121254343
  • 跳转链接
  • └ price
  • String
  • 可选
  • 999900
  • 价格
  • └ bid_count
  • Number
  • 可选
  • 899900
  • 销量
  • └ quantity
  • Number
  • 可选
  • 10
  • 库存
  • └ first_starts_time
  • Date
  • 可选
  • 2023-04-26 14:51:03
  • 首次上架时间
  • └ starts
  • Date
  • 可选
  • 2023-04-26 14:51:03
  • 最近上架时间
  • └ category_id
  • String
  • 可选
  • 16 50010850
  • 主站类目路径,空格分隔多级
  • └ 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
  • life_cycle_list
  • ItemLifeCycleViewVO []
  • 可选
  • 新品冷启期
  • 生命周期指标-越迁阶段列表,列表中最多有2个元素。在页面上展示的时候,按照元素的索引,从左到右依次展示即
  • └ life_cycle_desc
  • String
  • 可选
  • 新品打爆期
  • 周期文案
  • └ color
  • String
  • 可选
  • #36A2FC
  • 文案颜色
  • └ tips
  • String
  • 可选
  • 近30日GMV排名在叶子类目5%以内的新品
  • 周期提示文案
  • └ type
  • Number
  • 可选
  • 1
  • 生命周期类型
  • └ life_cycle_days
  • Number
  • 可选
  • 3
  • 生命周期指标-天数
  • └ life_cycle_diff_with_avg
  • String
  • 可选
  • 较慢
  • 生命周期指标-同叶子类目均值对比
  • └ life_cycle_diff_with_avg_tips
  • String
  • 可选
  • 快于同类目商品经历过同样阶段变化所用时间
  • 生命周期指标-同叶子类目均值对比提示文案
  • └ grow_desc
  • String
  • 可选
  • 日均再成交122.55元 可提高爆品类目排名卡位
  • 商品成长指标-成长文案
  • └ grow_rank
  • Number
  • 可选
  • 1077
  • 商品成长指标-成交排名
  • └ promotion_scene
  • String
  • 可选
  • promotion_scene_crowd
  • 推广场景,promotion_scene_crowd:人群方舟,promotion_scene_item:店铺宝贝运营,promotion_scene_traffic:宝藏场景,AD_STRATEGY_LAXIN:策略中心拉新场景,AD_STRATEGY_SHANGXINLI:策略中心上新礼场景,AD_STRATEGY_FRESH_BOX:策略中心小黑盒场景,AD_STRATEGY_LAXIN_XINXIANG:策略中心拉新新享一笔钱场景,AD_STRATEGY_RUHUI_NEW:策略中心入会快新会员场景,AD_STRATEGY_RUHUI_OLD:策略中心入会快老会员场景,AD_STRATEGY_LIUZI:策略中心留资快场景,AD_STRATEGY_YURE:策略中心活动加速场景,AD_STRATEGY_HUODONG_ESCORT:活动全周期护航计划,AD_STRATEGY_CROWD_INDUSTRY:策略中心行业人群通,AD_STRATEGY_WHOLE_SHOP_SMART:策略中心全店放心推-智能托管,AD_STRATEGY_WHOLE_SHOP_CUSTOM:策略中心全店放心推-自定义,AD_STRATEGY_EVEN_BUDGET:策略中心均匀曝光场景,AD_STRATEGY_SXK_GUARANTEE:万相台上新快确定性保障,AD_STRATEGY_HPJS_GUARANTEE:万相台货品加速确定性保障,AD_STRATEGY_HPJS_TIME_LIMIT:万相台货品加速限时加速,AD_STRATEGY_FANS_HEADLINES:万相台粉丝头条,WXT_AGENCY_XST_CPC:服务商版一键起量(CPC),WXT_AGENCY_XST_CPA:服务商版客源多(CPA),WXT_AGENCY_SHEQUN:服务商版社群(CPA+CPS)
  • └ optimize_target
  • String
  • 可选
  • conv
  • 优化目标,conv:促进成交,coll_cart:促进加购,click:促进点击,deal_count:促进成交笔数,exposure_pv:促进曝光,mini_view:促进橱窗宝贝浏览个数,mini_interactive:促进橱窗宝贝互动,ad_strategy_wangwang:策略中心旺旺咨询,shop_potential:提升潜客人数,shop_interest_new:提升兴趣新客人数,shop_purchase_new:提升首购新客人数,shop_visit_new:提升访问新客人数,shop_repurchase:提升复购人数,high_cvr:提升高转换人群成交人数,deeplink_d:提升品牌发现人数-D,deeplink_e1:提升品牌种草人数-E,deeplink_e2:提升品牌互动人数-E,deeplink_p:提升品牌行动人数-P,deeplink_i:提升品牌首购人数-I,deeplink_n:提升品牌复购人数-N,deeplink_k:提升品牌挚爱人数-K,hf_grass_plant:预热种草,hf_impoundment:预售蓄水,hf_harvest:爆发收割,nd_click:提高互动量,nd_cart:提高加购量,nd_deal:提高成交量,ad_strategy_ruhui_count:策略中心入会快新会员场景入会量目标,ad_strategy_lzl:策略中心留资快留资量目标,ad_strategy_try:策略中心派样量,ad_strategy_view:策略中心优化展现,ad_strategy_auto_trans:策略中心自动流转,ad_strategy_trial_order:策略中心表单获客成本,ad_strategy_liuzi_cost:策略中心广义留资目标,ad_strategy_cool_start:策略中心自动冷启动,ad_strategy_cool_start_mini_aim:策略中心冷启动分阶段目标流转,wxt_agency_ai:A转I人群流转,wxt_agency_smart:自定义场景,form_submit:表单提交,trial_order:试用下单,wangwang_liuzi:旺旺留资
  • └ item_selected_mode
  • String
  • 可选
  • shop
  • 选品方式,shop:全店优选,user_define:用户自定义选品,scope:范围圈选,trend:趋势选品

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • creative_adzone_preview_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • creative_adzone_preview_v_o_list
  • CreativeAdzonePreviewVO []
  • 批量成功结果集
  • └ adzone_type
  • Number
  • 1
  • 资源位类型,1:首焦,2:猜你喜欢,3:NewDetail
  • └ adzone_name
  • String
  • 全屏微详情
  • 资源包名字
  • └ adzone_id
  • Number
  • 111287850198
  • 资源包id
  • preview_data_list
  • CreativePreviewResultVO []
  • 创意预览返回前端展示对象
  • └ preview_format
  • Number
  • 2
  • 预览创意类型,2:图片,10:创意模板,12:微视频
  • └ preview_img_url
  • String
  • https://kb-render.chuangyi.taobao.com/template/93214.html?data=%7B%22image%22%3A%22https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi2%2F2247603103%2FO1CN011YnDptRlLOusjIj_%21%212247603103-0-alimamacc.jpg%22%2C%22video_duration%22%3A6%2C%22buyInfo%22%3A%220%E4%BA%BA%E4%BB%98%E6%AC%BE%22%2C%22price%22%3A110.00%2C%22video%22%3A%22https%3A%2F%2Fcloud.video.taobao.com%2Fplay%2Fu%2F2%2C247%2C603%2C103%2Fp%2F2%2Fe%2F6%2Ft%2F1%2F412128529977.mp4%3FsBizCode%3Dalimama_tuijian.mp4%22%2C%22title%22%3A%22%E4%B8%BB%E5%9B%BE%E8%A7%86%E9%A2%91%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%E7%8C%AB%E7%B2%AE%E5%B9%BC%E7%8C%AB%E5%A5%B6%E7%B3%95%E7%8C%AB%E4%B8%BB%E7%B2%AE%22%7D
  • 预览创意图片地址
  • └ preview_click_url
  • String
  • https://a.m.taobao.com/i678729730773.htm
  • 预览落地页地址
  • └ preview_size
  • String
  • 342x530
  • 预览创意尺寸
  • └ preview_scale
  • String
  • 0.5
  • 预览创意尺寸
  • └ preview_video_path
  • String
  • 342x530
  • 视频地址
  • └ preview_video_image
  • String
  • 342x530
  • 视频封面

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewCreativePreviewRequest req = new UniversalbpNewCreativePreviewRequest();
UniversalbpNewCreativePreviewRequest.TopServiceContext obj1 = new UniversalbpNewCreativePreviewRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewCreativePreviewRequest.CreativePreviewQueryVO obj2 = new UniversalbpNewCreativePreviewRequest.CreativePreviewQueryVO();
List<UniversalbpNewCreativePreviewRequest.AdzoneVO> list4 = new ArrayList<UniversalbpNewCreativePreviewRequest.AdzoneVO>();
UniversalbpNewCreativePreviewRequest.AdzoneVO obj5 = new UniversalbpNewCreativePreviewRequest.AdzoneVO();
list4.add(obj5);
obj5.setAdzoneId(111287850198L);
obj5.setAdzoneName("全屏微详情");
obj5.setDescription("首页及购中后的全屏微详情场景");
obj5.setImgUrl("https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png");
obj2.setAdzoneList(list4);
obj2.setCampaignId(68796878069L);
UniversalbpNewCreativePreviewRequest.CreativeVO obj6 = new UniversalbpNewCreativePreviewRequest.CreativeVO();
obj6.setCreativeId(6843262308L);
obj6.setCreativeName("sss");
obj6.setCreativeType(1L);
obj6.setSource(1L);
obj6.setCreativeCenterId("225349579");
obj6.setTpFormat(2L);
List<UniversalbpNewCreativePreviewRequest.ItemMaterialVO> list8 = new ArrayList<UniversalbpNewCreativePreviewRequest.ItemMaterialVO>();
UniversalbpNewCreativePreviewRequest.ItemMaterialVO obj9 = new UniversalbpNewCreativePreviewRequest.ItemMaterialVO();
list8.add(obj9);
obj9.setMaterialId(714616513841L);
obj9.setVideoId(398436114008L);
obj9.setSource(1L);
obj9.setHaitangId(989898L);
obj9.setFormatType(1L);
obj6.setMaterialList(list8);
obj6.setTemplateId(2000000000L);
obj6.setOuterId(225349579L);
obj6.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\"
        }");
obj6.setClickurlMediaTypeList("1");
UniversalbpNewCreativePreviewRequest.AuditVO obj10 = new UniversalbpNewCreativePreviewRequest.AuditVO();
obj10.setStatus("W");
obj10.setAuditStatus(2L);
obj10.setEffectiveTime("2023-05-29 18:21:40");
obj10.setExpireTime("2999-12-31 23:59:59");
obj10.setAuditReason("直播已结束,结束后创意自动变为审核拒绝状态");
obj6.setAudit(obj10);
List<UniversalbpNewCreativePreviewRequest.AuditVO> list12 = new ArrayList<UniversalbpNewCreativePreviewRequest.AuditVO>();
UniversalbpNewCreativePreviewRequest.AuditVO obj13 = new UniversalbpNewCreativePreviewRequest.AuditVO();
list12.add(obj13);
obj13.setStatus("W");
obj13.setAuditStatus(2L);
obj13.setEffectiveTime("2023-05-29 18:21:40");
obj13.setExpireTime("2999-12-31 23:59:59");
obj13.setAuditReason("直播已结束,结束后创意自动变为审核拒绝状态");
obj6.setAdzoneAuditResultList(list12);
List<UniversalbpNewCreativePreviewRequest.CreativeAdzonePreviewVO> list15 = new ArrayList<UniversalbpNewCreativePreviewRequest.CreativeAdzonePreviewVO>();
UniversalbpNewCreativePreviewRequest.CreativeAdzonePreviewVO obj16 = new UniversalbpNewCreativePreviewRequest.CreativeAdzonePreviewVO();
list15.add(obj16);
obj16.setAdzoneType(1L);
obj16.setAdzoneName("全屏微详情");
obj16.setAdzoneId(111287850198L);
List<UniversalbpNewCreativePreviewRequest.CreativePreviewResultVO> list19 = new ArrayList<UniversalbpNewCreativePreviewRequest.CreativePreviewResultVO>();
UniversalbpNewCreativePreviewRequest.CreativePreviewResultVO obj20 = new UniversalbpNewCreativePreviewRequest.CreativePreviewResultVO();
list19.add(obj20);
obj20.setPreviewFormat(2L);
obj20.setPreviewClickUrl("https://a.m.taobao.com/i678729730773.htm");
obj20.setPreviewSize("342x530");
obj20.setPreviewScale("0.5");
obj20.setPreviewVideoPath("342x530");
obj20.setPreviewVideoImage("342x530");
list17.setPreviewDataList(list19);
obj6.setPreviewList(list15);
obj6.setCreativeSize("513x750");
List<UniversalbpNewCreativePreviewRequest.ItemVideoVO> list22 = new ArrayList<UniversalbpNewCreativePreviewRequest.ItemVideoVO>();
UniversalbpNewCreativePreviewRequest.ItemVideoVO obj23 = new UniversalbpNewCreativePreviewRequest.ItemVideoVO();
list22.add(obj23);
obj23.setPoster("https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg");
obj23.setItemId(708275631127L);
obj23.setAuditState(1L);
obj23.setAuditDesc("xxxxx");
obj23.setVideoId(415780011227L);
obj23.setSource(1L);
obj23.setType(1L);
obj23.setWidth(800L);
obj23.setHeight(1200L);
obj23.setDuration(32L);
obj23.setHaitangId(989898L);
obj6.setItemVideos(list22);
obj6.setOnlineStatus(1L);
obj6.setStartTime("2023-05-29 18:00:00");
obj6.setEndTime("2024-05-28 17:59:00");
obj6.setCreateTime("2023-05-29 18:21:40");
obj6.setUpdateTime("2023-05-29 18:21:40");
UniversalbpNewCreativePreviewRequest.CreativePromotionEntityVO obj24 = new UniversalbpNewCreativePreviewRequest.CreativePromotionEntityVO();
obj24.setPromotionType("item");
obj24.setSubPromotionType("item");
obj24.setPromotionEntityId(714616513841L);
UniversalbpNewCreativePreviewRequest.PromotionMaterialInfoVO obj25 = new UniversalbpNewCreativePreviewRequest.PromotionMaterialInfoVO();
obj25.setMaterialId(714616513841L);
obj25.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj25.setMaterialName("yiliantest测试请不要拍22");
obj25.setTitle("yiliantest测试请不要拍22");
obj24.setMaterial(obj25);
obj6.setCreativePromotionEntity(obj24);
UniversalbpNewCreativePreviewRequest.MaterialImageInfoVO obj26 = new UniversalbpNewCreativePreviewRequest.MaterialImageInfoVO();
obj26.setMaterialId(714616513841L);
obj26.setImagePosition(0L);
obj26.setMaterialName("外投宝贝测试,请不要拍");
obj6.setMaterialImageInfo(obj26);
obj6.setTitle("薄荷脑软膏,测试请不要拍");
obj6.setImagePath("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj6.setVideoId(398436114008L);
obj6.setVideoDuration("10");
obj6.setVideoImagePath("https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg");
obj6.setItemIdList(new Long[] { 679056995041 };
);
List<UniversalbpNewCreativePreviewRequest.CreativeChildrenVO> list28 = new ArrayList<UniversalbpNewCreativePreviewRequest.CreativeChildrenVO>();
UniversalbpNewCreativePreviewRequest.CreativeChildrenVO obj29 = new UniversalbpNewCreativePreviewRequest.CreativeChildrenVO();
list28.add(obj29);
List<UniversalbpNewCreativePreviewRequest.ItemMaterialVO> list32 = new ArrayList<UniversalbpNewCreativePreviewRequest.ItemMaterialVO>();
UniversalbpNewCreativePreviewRequest.ItemMaterialVO obj33 = new UniversalbpNewCreativePreviewRequest.ItemMaterialVO();
list32.add(obj33);
obj33.setMaterialId(714616513841L);
obj33.setVideoId(398436114008L);
obj33.setSource(1L);
obj33.setHaitangId(989898L);
obj33.setFormatType(1L);
list30.setMaterialList(list32);
obj6.setChildren(list28);
obj6.setTabType("103");
obj6.setTabTypeName("103");
obj6.setTypeName("自定义创意");
obj6.setType("1");
obj6.setMainPicVideo("1");
obj6.setReportInfoMap("");
obj6.setAdgroupId(68796878061L);
obj2.setCreative(obj6);
UniversalbpNewCreativePreviewRequest.MaterialImageInfoVO obj34 = new UniversalbpNewCreativePreviewRequest.MaterialImageInfoVO();
obj34.setMaterialId(714616513841L);
obj34.setImagePosition(0L);
obj34.setMaterialName("外投宝贝测试,请不要拍");
obj2.setMaterialImageInfo(obj34);
UniversalbpNewCreativePreviewRequest.CommonMaterialVO obj35 = new UniversalbpNewCreativePreviewRequest.CommonMaterialVO();
obj35.setMaterialId(714616513841L);
obj35.setMaterialType(1L);
obj35.setMaterialName("yiliantest测试请不要拍22");
obj35.setTitle("yiliantest测试请不要拍22");
obj35.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj35.setPrice("999900");
obj35.setBidCount(899900L);
obj35.setQuantity(10L);
obj35.setFirstStartsTime(StringUtils.parseDateTime("2023-04-26 14:51:03"));
obj35.setStarts(StringUtils.parseDateTime("2023-04-26 14:51:03"));
obj35.setCategoryId("16 50010850");
obj35.setPromotionType("item");
obj35.setSubPromotionType("item");
List<UniversalbpNewCreativePreviewRequest.ItemLifeCycleViewVO> list37 = new ArrayList<UniversalbpNewCreativePreviewRequest.ItemLifeCycleViewVO>();
UniversalbpNewCreativePreviewRequest.ItemLifeCycleViewVO obj38 = new UniversalbpNewCreativePreviewRequest.ItemLifeCycleViewVO();
list37.add(obj38);
obj38.setLifeCycleDesc("新品打爆期");
obj38.setColor("#36A2FC");
obj38.setTips("近30日GMV排名在叶子类目5%以内的新品");
obj38.setType(1L);
obj35.setLifeCycleList(list37);
obj35.setLifeCycleDays(3L);
obj35.setLifeCycleDiffWithAvg("较慢");
obj35.setLifeCycleDiffWithAvgTips("快于同类目商品经历过同样阶段变化所用时间");
obj35.setGrowDesc("日均再成交122.55元 可提高爆品类目排名卡位");
obj35.setGrowRank(1077L);
obj2.setMaterialInfo(obj35);
obj2.setPromotionScene("promotion_scene_crowd");
obj2.setOptimizeTarget("conv");
obj2.setItemSelectedMode("shop");
req.setCreativePreviewQueryVO(obj2);
UniversalbpNewCreativePreviewResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<universalbp_new_creative_preview_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <creative_adzone_preview_v_o_top_bulk_data>
            <count>10</count>
            <creative_adzone_preview_v_o_list>
                <creative_adzone_preview_v_o>
                    <adzone_type>1</adzone_type>
                    <adzone_name>全屏微详情</adzone_name>
                    <adzone_id>111287850198</adzone_id>
                    <preview_data_list>
                        <creative_preview_result_v_o>
                            <preview_format>2</preview_format>
                            <preview_click_url>https://a.m.taobao.com/i678729730773.htm</preview_click_url>
                            <preview_size>342x530</preview_size>
                            <preview_scale>0.5</preview_scale>
                            <preview_video_path>342x530</preview_video_path>
                            <preview_video_image>342x530</preview_video_image>
                        </creative_preview_result_v_o>
                    </preview_data_list>
                </creative_adzone_preview_v_o>
            </creative_adzone_preview_v_o_list>
        </creative_adzone_preview_v_o_top_bulk_data>
    </top_result>
</universalbp_new_creative_preview_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

返回
顶部