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

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

预览创意

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
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:是,其他不是
  • └ 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
  • 可选
  • 物料信息
  • └ 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
  • └ 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:趋势选品

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • creative_adzone_preview_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • 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
  • 视频封面
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCreativePreviewRequest req = new UniversalbpCreativePreviewRequest();
UniversalbpCreativePreviewRequest.TopServiceContext obj1 = new UniversalbpCreativePreviewRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCreativePreviewRequest.CreativePreviewQueryVo obj2 = new UniversalbpCreativePreviewRequest.CreativePreviewQueryVo();
List<UniversalbpCreativePreviewRequest.AdzoneVo> list4 = new ArrayList<UniversalbpCreativePreviewRequest.AdzoneVo>();
UniversalbpCreativePreviewRequest.AdzoneVo obj5 = new UniversalbpCreativePreviewRequest.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);
UniversalbpCreativePreviewRequest.CreativeVo obj6 = new UniversalbpCreativePreviewRequest.CreativeVo();
obj6.setCreativeId(6843262308L);
obj6.setCreativeName("sss");
obj6.setCreativeType(1L);
obj6.setSource(1L);
obj6.setCreativeCenterId("225349579");
obj6.setTpFormat(2L);
List<UniversalbpCreativePreviewRequest.ItemMaterialVo> list8 = new ArrayList<UniversalbpCreativePreviewRequest.ItemMaterialVo>();
UniversalbpCreativePreviewRequest.ItemMaterialVo obj9 = new UniversalbpCreativePreviewRequest.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");
obj6.setMaterialList(list8);
obj6.setTemplateId(2000000000L);
obj6.setOuterId(225349579L);
obj6.setJsInHtml("https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html");
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");
UniversalbpCreativePreviewRequest.AuditVo obj10 = new UniversalbpCreativePreviewRequest.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<UniversalbpCreativePreviewRequest.AuditVo> list12 = new ArrayList<UniversalbpCreativePreviewRequest.AuditVo>();
UniversalbpCreativePreviewRequest.AuditVo obj13 = new UniversalbpCreativePreviewRequest.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<UniversalbpCreativePreviewRequest.CreativeAdzonePreviewVo> list15 = new ArrayList<UniversalbpCreativePreviewRequest.CreativeAdzonePreviewVo>();
UniversalbpCreativePreviewRequest.CreativeAdzonePreviewVo obj16 = new UniversalbpCreativePreviewRequest.CreativeAdzonePreviewVo();
list15.add(obj16);
obj16.setAdzoneType(1L);
obj16.setAdzoneName("全屏微详情");
obj16.setAdzoneId(111287850198L);
List<UniversalbpCreativePreviewRequest.CreativePreviewResultVo> list19 = new ArrayList<UniversalbpCreativePreviewRequest.CreativePreviewResultVo>();
UniversalbpCreativePreviewRequest.CreativePreviewResultVo obj20 = new UniversalbpCreativePreviewRequest.CreativePreviewResultVo();
list19.add(obj20);
obj20.setPreviewFormat(2L);
obj20.setPreviewImgUrl("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");
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<UniversalbpCreativePreviewRequest.ItemVideoVo> list22 = new ArrayList<UniversalbpCreativePreviewRequest.ItemVideoVo>();
UniversalbpCreativePreviewRequest.ItemVideoVo obj23 = new UniversalbpCreativePreviewRequest.ItemVideoVo();
list22.add(obj23);
obj23.setCoverUrl("https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png");
obj23.setPoster("https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg");
obj23.setItemId(708275631127L);
obj23.setVideoUrl("https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4");
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");
UniversalbpCreativePreviewRequest.CreativePromotionEntityVo obj24 = new UniversalbpCreativePreviewRequest.CreativePromotionEntityVo();
obj24.setPromotionType("item");
obj24.setSubPromotionType("item");
obj24.setPromotionEntityId(714616513841L);
UniversalbpCreativePreviewRequest.PromotionMaterialInfoVo obj25 = new UniversalbpCreativePreviewRequest.PromotionMaterialInfoVo();
obj25.setMaterialId(714616513841L);
obj25.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj25.setLinkUrl("http://item.taobao.com/item.htm?id=715121254343");
obj25.setMaterialName("yiliantest测试请不要拍22");
obj25.setTitle("yiliantest测试请不要拍22");
obj24.setMaterial(obj25);
obj6.setCreativePromotionEntity(obj24);
obj6.setExtendData("https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html");
UniversalbpCreativePreviewRequest.MaterialImageInfoVo obj26 = new UniversalbpCreativePreviewRequest.MaterialImageInfoVo();
obj26.setMaterialId(714616513841L);
obj26.setImagePosition(0L);
obj26.setImgUrl("https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj26.setLinkUrl("http://item.taobao.com/item.htm?id=668800719012");
obj26.setMaterialName("外投宝贝测试,请不要拍");
obj6.setMaterialImageInfo(obj26);
obj6.setTitle("薄荷脑软膏,测试请不要拍");
obj6.setImagePath("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj6.setClickUrl("https://a.m.taobao.com/i679056995041.htm");
obj6.setVideoId(398436114008L);
obj6.setVideoDuration("10");
obj6.setVideoPath("https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4");
obj6.setVideoImagePath("https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg");
obj6.setItemIdList(new Long[] { 679056995041 };
);
List<UniversalbpCreativePreviewRequest.CreativeChildrenVo> list28 = new ArrayList<UniversalbpCreativePreviewRequest.CreativeChildrenVo>();
UniversalbpCreativePreviewRequest.CreativeChildrenVo obj29 = new UniversalbpCreativePreviewRequest.CreativeChildrenVo();
list28.add(obj29);
List<UniversalbpCreativePreviewRequest.ItemMaterialVo> list32 = new ArrayList<UniversalbpCreativePreviewRequest.ItemMaterialVo>();
UniversalbpCreativePreviewRequest.ItemMaterialVo obj33 = new UniversalbpCreativePreviewRequest.ItemMaterialVo();
list32.add(obj33);
obj33.setMaterialId(714616513841L);
obj33.setVideoId(398436114008L);
obj33.setSource(1L);
obj33.setHaitangId(989898L);
obj33.setFormatType(1L);
obj33.setUrl("https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg");
obj33.setCoverUrl("https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png");
list30.setMaterialList(list32);
obj6.setChildren(list28);
obj6.setTabType("103");
obj6.setTabTypeName("103");
obj6.setTypeName("自定义创意");
obj6.setType("1");
obj6.setMainPicVideo("1");
obj6.setAdgroupId(68796878061L);
obj2.setCreative(obj6);
UniversalbpCreativePreviewRequest.MaterialImageInfoVo obj34 = new UniversalbpCreativePreviewRequest.MaterialImageInfoVo();
obj34.setMaterialId(714616513841L);
obj34.setImagePosition(0L);
obj34.setImgUrl("https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj34.setLinkUrl("http://item.taobao.com/item.htm?id=668800719012");
obj34.setMaterialName("外投宝贝测试,请不要拍");
obj2.setMaterialImageInfo(obj34);
UniversalbpCreativePreviewRequest.CommonMaterialVo obj35 = new UniversalbpCreativePreviewRequest.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.setLinkUrl("http://item.taobao.com/item.htm?id=715121254343");
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");
obj2.setMaterialInfo(obj35);
obj2.setPromotionScene("promotion_scene_crowd");
obj2.setOptimizeTarget("conv");
obj2.setItemSelectedMode("shop");
req.setCreativePreviewQueryVO(obj2);
UniversalbpCreativePreviewResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_creative_preview_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <creative_adzone_preview_v_o_top_bulk_data>
            <creative_adzone_preview_v_o_list>
                <creative_adzone_preview_vo>
                    <adzone_type>1</adzone_type>
                    <adzone_name>全屏微详情</adzone_name>
                    <adzone_id>111287850198</adzone_id>
                    <preview_data_list>
                        <creative_preview_result_vo>
                            <preview_format>2</preview_format>
                            <preview_img_url>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_img_url>
                            <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_vo>
                    </preview_data_list>
                </creative_adzone_preview_vo>
            </creative_adzone_preview_v_o_list>
            <count>1</count>
        </creative_adzone_preview_v_o_top_bulk_data>
    </result>
</universalbp_creative_preview_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

返回
顶部