← 万相台接口目录

接口参考 · 修改操作

创建创意

taobao.universalbp.new.creative.add

核对日期:2026-09-19。字段名称、类型与业务层级按淘宝文档整理;请求地址、鉴权和店铺选择按下方本站说明接入。

文档按上述日期核对;最新变更及详细场景规则请查看淘宝官方说明。

通过奇门云调用

  • 签名地址:POST https://api.miandanni.com/api/wanxiang/sign;Content-Type: application/json。
  • 客户购买的奇门云密钥用于申请签名;实际调用淘宝开放平台万相台官方 API。方法、字段、类型、层级、金额单位和场景以官方文档为准。奇门云校验客户服务、店铺归属与授权后签名,客户服务器直接请求淘宝并接收业务数据。
  • 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在业务脚本同目录,使用 Client.call。奇门云密钥不是淘宝 AppSecret;不要求客户自行计算平台签名。
  • 签名申请头 Authorization: Bearer 你的奇门云密钥。JSON 为 {shopKey, method, params};shopKey 必须属于当前客户。客户 Bearer 密钥不能转发到淘宝。
  • 业务参数放入 params,保留淘宝字段名、类型、层级及枚举。对象直接使用 JSON 对象;下表业务根字段不放在请求最外层。
  • app_key、session、sign、timestamp、v、format 等公共字段由服务器生成。签发的本店铺 session 和签名只能用于客户服务器,不进入前端、日志或公共仓库;AppSecret 和 refresh_token 不提供给客户。
  • 本站支持店铺直接登录:top_service_context.login_type 为 1,ext 为 {} 或字符串 "{}";不允许 member_id、其他账户身份或代理登录。官方表内此类字段用于说明差异,不能照抄传入。
  • 业务根对象未填写的必填子项需按官方文档补全。ID 保持精度,金额单位、日期范围和枚举以具体方法官方说明为准。
  • 签发成功为 {ok:true,data:{version:1,ticketId,service,method,issuedAt,request}},不表示业务已执行;客户端按合同执行 data.request。TOP fields 原样作为字符串表单发送,不改值。
  • 淘宝业务响应直接返回客户程序,保留 error_response、top_result、逐项错误和 request_id;HTTP 200 仍检查 top_result.info.ok。签名阶段失败读取奇门云 error.code、message 和 details。
  • 每次签名校验密钥、服务有效期、店铺归属、淘宝应用订购及授权。业务能力仍取决于淘宝资格与推广场景。签发限流不等于平台实际调用次数。
  • 一次签名只生成一份请求,不自动翻页或重试。创建、调价、启停、删除会实际生效;超时或结果未知先查询实际状态。ticketId 不是平台幂等键。
  • 签名不是一次性凭据,平台接受的时间窗口内可能重放;解绑、停用或到期阻止新签发,不能即时撤回已签发请求。老客户原程序继续可用。
  • 每周一北京时间凌晨2:00检查官方更新,经核对验证后同步,不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈,不误判为平台权限不足。
{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.add",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_command_list_v_o": {}
  }
}

这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。

请求业务参数

以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。

官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。

89 / 89 个字段
字段路径类型 / 必填字段含义示例值
top_service_contextTopServiceContext必填含下级字段推广业务上下文—
top_service_context.biz_codeString必填推广场景标识xxxxx
top_service_context.login_typeNumber可选账户登录方式枚举:1、2=代理直投(叉乘账号)1
top_service_context.member_idNumber可选广告账户标识代理直投(叉乘)时必填12345
top_service_context.extString可选扩展参数{}
creative_command_list_v_oCreativeCommandListVO必填含下级字段创意操作列表—
creative_command_list_v_o.creative_listCreativeCommandVO []必填含下级字段创意列表—
creative_command_list_v_o.creative_list[].creative_idNumber可选广告创意编号6843262308
creative_command_list_v_o.creative_list[].creative_nameString可选广告创意名称sss
creative_command_list_v_o.creative_list[].sourceNumber可选请求来源标识枚举:1=本地上传、3=CreativeCenter1
creative_command_list_v_o.creative_list[].tp_formatNumber可选业务字段 tp_format枚举:2=图片、10=创意模板、12=微视频2
creative_command_list_v_o.creative_list[].start_timeString可选查询或投放起始时间2023-05-29 18:00:00
creative_command_list_v_o.creative_list[].end_timeString可选查询或投放结束时间2024-05-28 17:59:00
creative_command_list_v_o.creative_list[].titleString可选展示标题薄荷脑软膏,测试请不要拍
creative_command_list_v_o.creative_list[].image_pathString可选业务字段 image_pathhttps://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
creative_command_list_v_o.creative_list[].click_urlString可选业务字段 click_urlhttps://a.m.taobao.com/i679056995041.htm
creative_command_list_v_o.creative_list[].video_idNumber可选视频标识398436114008
creative_command_list_v_o.creative_list[].creative_protectionNumber可选业务字段 creative_protection1
creative_command_list_v_o.creative_list[].video_durationString可选业务字段 video_duration10
creative_command_list_v_o.creative_list[].video_pathString可选业务字段 video_pathhttps://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4
creative_command_list_v_o.creative_list[].video_image_pathString可选业务字段 video_image_pathhttps://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg
creative_command_list_v_o.creative_list[].material_listItemMaterialVO []可选含下级字段素材列表—
creative_command_list_v_o.creative_list[].material_list[].material_idNumber可选素材标识714616513841
creative_command_list_v_o.creative_list[].material_list[].video_idNumber可选视频标识398436114008
creative_command_list_v_o.creative_list[].material_list[].sourceNumber可选请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意1
creative_command_list_v_o.creative_list[].material_list[].haitang_idNumber可选业务对象标识989898
creative_command_list_v_o.creative_list[].material_list[].format_typeNumber可选业务字段 format_type枚举: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、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=仅合理性审核的文案1
creative_command_list_v_o.creative_list[].material_list[].urlString可选资源地址https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
creative_command_list_v_o.creative_list[].material_list[].cover_urlString可选业务字段 cover_urlhttps://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
creative_command_list_v_o.creative_list[].creative_sizeString可选业务字段 creative_size513x750
creative_command_list_v_o.creative_list[].creative_promotion_entityCreativePromotionEntityVO可选含下级字段创意对象—
creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_typeString可选业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义item
creative_command_list_v_o.creative_list[].creative_promotion_entity.sub_promotion_typeString可选业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义urlitem
creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_entity_idNumber可选业务对象标识714616513841
creative_command_list_v_o.creative_list[].creative_promotion_entity.materialPromotionMaterialInfoVO可选含下级字段素材—
creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_idNumber可选素材标识714616513841
creative_command_list_v_o.creative_list[].creative_promotion_entity.material.img_urlString可选业务字段 img_url//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
creative_command_list_v_o.creative_list[].creative_promotion_entity.material.link_urlString可选业务字段 link_urlhttp://item.taobao.com/item.htm?id=715121254343
creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_nameString可选素材名称yiliantest测试请不要拍22
creative_command_list_v_o.creative_list[].creative_promotion_entity.material.titleString可选展示标题yiliantest测试请不要拍22
creative_command_list_v_o.creative_list[].template_dataString可选业务字段 template_data—
creative_command_list_v_o.creative_list[].js_in_htmlString可选业务字段 js_in_htmlhttps://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
creative_command_list_v_o.creative_list[].outer_idNumber可选业务对象标识225349579
creative_command_list_v_o.creative_list[].creative_center_idString可选创意标识225349579
creative_command_list_v_o.creative_list[].item_id_listNumber []可选商品标识列表[679056995041]
creative_command_list_v_o.creative_list[].clickurl_media_type_listString []可选类型集合枚举:1=PC、2=无线、3=PC和无线[1]
creative_command_list_v_o.creative_list[].tab_typeString可选业务字段 tab_type2
creative_command_list_v_o.creative_list[].template_idNumber可选模板标识2000000000
creative_command_list_v_o.creative_list[].campaign_idNumber可选推广计划编号68796878069
creative_command_list_v_o.creative_list[].adgroup_idNumber可选推广单元编号68793666608
creative_command_list_v_o.creative_list[].is_clipBoolean可选业务字段 is_clip枚举:true=是、false=否false
creative_command_list_v_o.creative_list[].material_group_idNumber可选素材标识1010
creative_command_list_v_o.creative_list[].media_material_listMediaMaterialInfoVO []可选含下级字段素材列表集合—
creative_command_list_v_o.creative_list[].media_material_list[].creative_idNumber可选广告创意编号6843262308
creative_command_list_v_o.creative_list[].media_material_list[].tp_formatNumber可选业务字段 tp_format2
creative_command_list_v_o.creative_list[].media_material_list[].start_timeDate可选查询或投放起始时间2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].media_material_list[].end_timeDate可选查询或投放结束时间2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].media_material_list[].effective_timeDate可选业务字段 effective_time2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].media_material_list[].expire_timeDate可选业务字段 expire_time2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].media_material_list[].material_nameString可选素材名称宝贝xxx名称
creative_command_list_v_o.creative_list[].media_material_list[].outer_idNumber可选业务对象标识1011
creative_command_list_v_o.creative_list[].media_material_list[].sourceNumber可选请求来源标识1
creative_command_list_v_o.creative_list[].media_material_list[].tagString可选业务字段 tagtag名称
creative_command_list_v_o.creative_list[].media_material_list[].item_idNumber可选商品编号6843262308
creative_command_list_v_o.creative_list[].media_material_list[].image_positionNumber可选业务字段 image_position1
creative_command_list_v_o.creative_list[].media_material_list[].image_pathString可选业务字段 image_pathhttp://localhost
creative_command_list_v_o.creative_list[].media_material_list[].video_idNumber可选视频标识1012
creative_command_list_v_o.creative_list[].media_material_list[].video_image_pathString可选业务字段 video_image_pathhttp://localhost
creative_command_list_v_o.creative_list[].media_material_list[].video_pathString可选业务字段 video_pathhttp://localhost
creative_command_list_v_o.creative_list[].media_material_list[].widthNumber可选业务字段 width200
creative_command_list_v_o.creative_list[].media_material_list[].heightNumber可选业务字段 height400
creative_command_list_v_o.creative_list[].media_material_list[].sync_keyString可选业务字段 sync_keyxxxxx
creative_command_list_v_o.creative_list[].media_material_list[].image_idNumber可选图片标识101
creative_command_list_v_o.creative_list[].media_material_list[].material_typeString可选素材类型title
creative_command_list_v_o.creative_list[].media_material_list[].material_idNumber可选素材标识714894818852
creative_command_list_v_o.creative_list[].media_material_list[].haitang_sourceNumber可选业务字段 haitang_source1
creative_command_list_v_o.creative_list[].title_material_listTextMaterialInfoVO []可选含下级字段素材列表集合—
creative_command_list_v_o.creative_list[].title_material_list[].creative_idNumber可选广告创意编号6843262308
creative_command_list_v_o.creative_list[].title_material_list[].material_idNumber可选素材标识714894818852
creative_command_list_v_o.creative_list[].title_material_list[].item_idNumber可选商品编号6843262308
creative_command_list_v_o.creative_list[].title_material_list[].start_timeDate可选查询或投放起始时间2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].title_material_list[].end_timeDate可选查询或投放结束时间2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].title_material_list[].effective_timeDate可选业务字段 effective_time2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].title_material_list[].expire_timeDate可选业务字段 expire_time2024-01-01 00:00:00
creative_command_list_v_o.creative_list[].title_material_list[].content_typeString可选内容类型title
creative_command_list_v_o.creative_list[].title_material_list[].contentString可选内容xxxxxx
creative_command_list_v_o.creative_list[].title_material_list[].material_typeString可选素材类型title
creative_command_list_v_o.creative_list[].title_material_list[].sourceNumber可选请求来源标识2
creative_command_list_v_o.creative_list[].creative_typeNumber可选创意类型20

返回业务字段

响应外层为 universalbp_new_creative_add_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。

155 / 155 个字段
字段路径类型 / 必填字段含义示例值
top_result样例 JSON:universalbp_new_creative_add_response.top_resultTopResult官方未标注必填含下级字段接口业务结果—
top_result.info样例 JSON:universalbp_new_creative_add_response.top_result.infoTopInfo官方未标注必填含下级字段执行状态信息—
top_result.info.ok样例 JSON:universalbp_new_creative_add_response.top_result.info.okBoolean官方未标注必填业务是否成功true
top_result.info.message样例 JSON:universalbp_new_creative_add_response.top_result.info.messageString官方未标注必填业务结果提示参数错误
top_result.info.error_code样例 JSON:universalbp_new_creative_add_response.top_result.info.error_codeString官方未标注必填业务错误标识xxxxx
top_result.top_creative_v_o样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_oTopCreativeVO官方未标注必填含下级字段创意—
top_result.top_creative_v_o.creative_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_listCreativeVO []官方未标注必填含下级字段创意列表—
top_result.top_creative_v_o.creative_list[].creative_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_idNumber官方未标注必填广告创意编号6843262308
top_result.top_creative_v_o.creative_list[].creative_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_nameString官方未标注必填广告创意名称sss
top_result.top_creative_v_o.creative_list[].adgroup_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adgroup_idNumber官方未标注必填推广单元编号68796878061
top_result.top_creative_v_o.creative_list[].creative_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_typeNumber官方未标注必填创意类型枚举:1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意1
top_result.top_creative_v_o.creative_list[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].sourceNumber官方未标注必填请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意1
top_result.top_creative_v_o.creative_list[].creative_center_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_center_idString官方未标注必填创意标识225349579
top_result.top_creative_v_o.creative_list[].format样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].formatNumber官方未标注必填业务字段 format枚举:1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意2
top_result.top_creative_v_o.creative_list[].material_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_listItemMaterialVO []官方未标注必填含下级字段素材列表—
top_result.top_creative_v_o.creative_list[].material_list[].material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].material_idNumber官方未标注必填素材标识714616513841
top_result.top_creative_v_o.creative_list[].material_list[].video_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].video_idNumber官方未标注必填视频标识398436114008
top_result.top_creative_v_o.creative_list[].material_list[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].sourceNumber官方未标注必填请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意1
top_result.top_creative_v_o.creative_list[].material_list[].haitang_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].haitang_idNumber官方未标注必填业务对象标识989898
top_result.top_creative_v_o.creative_list[].material_list[].format_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].format_typeNumber官方未标注必填业务字段 format_type枚举: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、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=仅合理性审核的文案1
top_result.top_creative_v_o.creative_list[].material_list[].url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].urlString官方未标注必填资源地址https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
top_result.top_creative_v_o.creative_list[].material_list[].cover_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].cover_urlString官方未标注必填业务字段 cover_urlhttps://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
top_result.top_creative_v_o.creative_list[].template_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_idNumber官方未标注必填模板标识2000000000
top_result.top_creative_v_o.creative_list[].outer_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].outer_idNumber官方未标注必填业务对象标识225349579
top_result.top_creative_v_o.creative_list[].js_in_html样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].js_in_htmlString官方未标注必填业务字段 js_in_htmlhttps://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
top_result.top_creative_v_o.creative_list[].template_data样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_dataString官方未标注必填业务字段 template_data—
top_result.top_creative_v_o.creative_list[].clickurl_media_type_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].clickurl_media_type_listString []官方未标注必填类型集合枚举:1=PC、2=无线、3=PC和无线[1]
top_result.top_creative_v_o.creative_list[].audit样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].auditAuditVO官方未标注必填含下级字段业务对象—
top_result.top_creative_v_o.creative_list[].audit.status样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.statusString官方未标注必填状态标识枚举:PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障W
top_result.top_creative_v_o.creative_list[].audit.audit_status样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_statusNumber官方未标注必填业务字段 audit_status枚举:-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_passed2
top_result.top_creative_v_o.creative_list[].audit.effective_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.effective_timeString官方未标注必填业务字段 effective_time2023-05-29 18:21:40
top_result.top_creative_v_o.creative_list[].audit.expire_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.expire_timeString官方未标注必填业务字段 expire_time2999-12-31 23:59:59
top_result.top_creative_v_o.creative_list[].audit.audit_reason样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_reasonString官方未标注必填业务字段 audit_reason直播已结束,结束后创意自动变为审核拒绝状态
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_listAuditVO []官方未标注必填含下级字段结果列表集合—
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].status样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].statusString官方未标注必填状态标识枚举:PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障W
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_status样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_statusNumber官方未标注必填业务字段 audit_status枚举:-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_passed2
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].effective_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].effective_timeString官方未标注必填业务字段 effective_time2023-05-29 18:21:40
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].expire_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].expire_timeString官方未标注必填业务字段 expire_time2999-12-31 23:59:59
top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_reason样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_reasonString官方未标注必填业务字段 audit_reason直播已结束,结束后创意自动变为审核拒绝状态
top_result.top_creative_v_o.creative_list[].preview_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_listCreativeAdzonePreviewVO []官方未标注必填含下级字段列表集合—
top_result.top_creative_v_o.creative_list[].preview_list[].adzone_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_typeNumber官方未标注必填业务字段 adzone_type枚举:1=首焦、2=猜你喜欢、3=NewDetail1
top_result.top_creative_v_o.creative_list[].preview_list[].adzone_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_nameString官方未标注必填业务字段 adzone_name全屏微详情
top_result.top_creative_v_o.creative_list[].preview_list[].adzone_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_idNumber官方未标注必填业务对象标识111287850198
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_listCreativePreviewResultVO []官方未标注必填含下级字段列表集合—
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_format样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_formatNumber官方未标注必填业务字段 preview_format枚举:2=图片、10=创意模板、12=微视频2
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_img_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_urlString官方未标注必填业务字段 preview_img_url—
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_click_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_urlString官方未标注必填业务字段 preview_click_urlhttps://a.m.taobao.com/i678729730773.htm
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_size样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_sizeString官方未标注必填业务字段 preview_size342x530
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_scale样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scaleString官方未标注必填业务字段 preview_scale0.5
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_pathString官方未标注必填业务字段 preview_video_path342x530
top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_image样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_imageString官方未标注必填业务字段 preview_video_image342x530
top_result.top_creative_v_o.creative_list[].creative_size样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_sizeString官方未标注必填业务字段 creative_size513x750
top_result.top_creative_v_o.creative_list[].item_videos样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videosItemVideoVO []官方未标注必填含下级字段商品集合—
top_result.top_creative_v_o.creative_list[].item_videos[].cover_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].cover_urlString官方未标注必填业务字段 cover_urlhttps://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
top_result.top_creative_v_o.creative_list[].item_videos[].poster样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].posterString官方未标注必填业务字段 posterhttps://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg
top_result.top_creative_v_o.creative_list[].item_videos[].item_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].item_idNumber官方未标注必填商品编号708275631127
top_result.top_creative_v_o.creative_list[].item_videos[].video_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_urlString官方未标注必填业务字段 video_urlhttps://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4
top_result.top_creative_v_o.creative_list[].item_videos[].audit_state样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_stateNumber官方未标注必填业务字段 audit_state枚举:-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_passed1
top_result.top_creative_v_o.creative_list[].item_videos[].audit_desc样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_descString官方未标注必填业务字段 audit_descxxxxx
top_result.top_creative_v_o.creative_list[].item_videos[].video_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_idNumber官方未标注必填视频标识415780011227
top_result.top_creative_v_o.creative_list[].item_videos[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].sourceNumber官方未标注必填请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意1
top_result.top_creative_v_o.creative_list[].item_videos[].type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].typeNumber官方未标注必填类型枚举: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、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=仅合理性审核的文案1
top_result.top_creative_v_o.creative_list[].item_videos[].width样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].widthNumber官方未标注必填业务字段 width800
top_result.top_creative_v_o.creative_list[].item_videos[].height样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].heightNumber官方未标注必填业务字段 height1200
top_result.top_creative_v_o.creative_list[].item_videos[].duration样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].durationNumber官方未标注必填业务字段 duration32
top_result.top_creative_v_o.creative_list[].item_videos[].haitang_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].haitang_idNumber官方未标注必填业务对象标识989898
top_result.top_creative_v_o.creative_list[].online_status样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].online_statusNumber官方未标注必填投放上下线状态枚举:1=ON、-1=ARCHIVE1
top_result.top_creative_v_o.creative_list[].start_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].start_timeString官方未标注必填查询或投放起始时间2023-05-29 18:00:00
top_result.top_creative_v_o.creative_list[].end_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].end_timeString官方未标注必填查询或投放结束时间2024-05-28 17:59:00
top_result.top_creative_v_o.creative_list[].create_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].create_timeString官方未标注必填业务字段 create_time2023-05-29 18:21:40
top_result.top_creative_v_o.creative_list[].update_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].update_timeString官方未标注必填业务字段 update_time2023-05-29 18:21:40
top_result.top_creative_v_o.creative_list[].creative_promotion_entity样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entityCreativePromotionEntityVO官方未标注必填含下级字段创意对象—
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_typeString官方未标注必填业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义item
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.sub_promotion_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.sub_promotion_typeString官方未标注必填业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义urlitem
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_entity_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_entity_idNumber官方未标注必填业务对象标识714616513841
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.materialPromotionMaterialInfoVO官方未标注必填含下级字段素材—
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_idNumber官方未标注必填素材标识714616513841
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.img_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.img_urlString官方未标注必填业务字段 img_url//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.link_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.link_urlString官方未标注必填业务字段 link_urlhttp://item.taobao.com/item.htm?id=715121254343
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_nameString官方未标注必填素材名称yiliantest测试请不要拍22
top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.title样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.titleString官方未标注必填展示标题yiliantest测试请不要拍22
top_result.top_creative_v_o.creative_list[].extend_data样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].extend_dataString官方未标注必填业务字段 extend_datahttps://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html
top_result.top_creative_v_o.creative_list[].material_image_info样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_infoMaterialImageInfoVO官方未标注必填含下级字段素材图片对象—
top_result.top_creative_v_o.creative_list[].material_image_info.material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_idNumber官方未标注必填素材标识714616513841
top_result.top_creative_v_o.creative_list[].material_image_info.sync_key样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.sync_keyString官方未标注必填业务字段 sync_keyxxxx
top_result.top_creative_v_o.creative_list[].material_image_info.image_position样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_positionNumber官方未标注必填业务字段 image_position0
top_result.top_creative_v_o.creative_list[].material_image_info.img_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.img_urlString官方未标注必填业务字段 img_urlhttps://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
top_result.top_creative_v_o.creative_list[].material_image_info.link_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.link_urlString官方未标注必填业务字段 link_urlhttp://item.taobao.com/item.htm?id=668800719012
top_result.top_creative_v_o.creative_list[].material_image_info.material_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_nameString官方未标注必填素材名称外投宝贝测试,请不要拍
top_result.top_creative_v_o.creative_list[].material_image_info.image_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_idNumber官方未标注必填图片标识101
top_result.top_creative_v_o.creative_list[].material_image_info.size样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.sizeString官方未标注必填业务字段 size800*800
top_result.top_creative_v_o.creative_list[].material_image_info.width样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.widthNumber官方未标注必填业务字段 width800
top_result.top_creative_v_o.creative_list[].material_image_info.height样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.heightNumber官方未标注必填业务字段 height800
top_result.top_creative_v_o.creative_list[].material_image_info.image_properties样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_propertiesString官方未标注必填业务字段 image_propertiesxxxxx
top_result.top_creative_v_o.creative_list[].title样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].titleString官方未标注必填展示标题薄荷脑软膏,测试请不要拍
top_result.top_creative_v_o.creative_list[].image_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].image_pathString官方未标注必填业务字段 image_pathhttps://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
top_result.top_creative_v_o.creative_list[].click_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].click_urlString官方未标注必填业务字段 click_urlhttps://a.m.taobao.com/i679056995041.htm
top_result.top_creative_v_o.creative_list[].video_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_idNumber官方未标注必填视频标识398436114008
top_result.top_creative_v_o.creative_list[].video_duration样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_durationString官方未标注必填业务字段 video_duration10
top_result.top_creative_v_o.creative_list[].video_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_pathString官方未标注必填业务字段 video_pathhttps://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4
top_result.top_creative_v_o.creative_list[].video_image_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_image_pathString官方未标注必填业务字段 video_image_pathhttps://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg
top_result.top_creative_v_o.creative_list[].item_id_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_id_listNumber []官方未标注必填商品标识列表[679056995041]
top_result.top_creative_v_o.creative_list[].children样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].childrenCreativeChildrenVO []官方未标注必填含下级字段业务集合—
top_result.top_creative_v_o.creative_list[].children[].material_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_listItemMaterialVO []官方未标注必填含下级字段素材列表—
top_result.top_creative_v_o.creative_list[].children[].material_list[].material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_idNumber官方未标注必填素材标识714616513841
top_result.top_creative_v_o.creative_list[].children[].material_list[].video_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_idNumber官方未标注必填视频标识398436114008
top_result.top_creative_v_o.creative_list[].children[].material_list[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].sourceNumber官方未标注必填请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意1
top_result.top_creative_v_o.creative_list[].children[].material_list[].haitang_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_idNumber官方未标注必填业务对象标识989898
top_result.top_creative_v_o.creative_list[].children[].material_list[].format_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_typeNumber官方未标注必填业务字段 format_type枚举: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、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=仅合理性审核的文案1
top_result.top_creative_v_o.creative_list[].children[].material_list[].url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].urlString官方未标注必填资源地址https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg
top_result.top_creative_v_o.creative_list[].children[].material_list[].cover_url样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_urlString官方未标注必填业务字段 cover_urlhttps://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png
top_result.top_creative_v_o.creative_list[].tab_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_typeString官方未标注必填业务字段 tab_type枚举: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=竖版视频1080x1920103
top_result.top_creative_v_o.creative_list[].tab_type_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_type_nameString官方未标注必填业务字段 tab_type_name枚举: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=竖版视频1080x1920103
top_result.top_creative_v_o.creative_list[].type_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].type_nameString官方未标注必填类型名称枚举:1=自定义创意、5=智能创意自定义创意
top_result.top_creative_v_o.creative_list[].type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].typeString官方未标注必填类型枚举:1=自定义创意、5=智能创意1
top_result.top_creative_v_o.creative_list[].main_pic_video样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].main_pic_videoString官方未标注必填业务字段 main_pic_video1
top_result.top_creative_v_o.creative_list[].media_material_count样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_countNumber官方未标注必填业务字段 media_material_count5
top_result.top_creative_v_o.creative_list[].title_material_count样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_countNumber官方未标注必填业务字段 title_material_count5
top_result.top_creative_v_o.creative_list[].media_material_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_listMediaMaterialInfoVO []官方未标注必填含下级字段素材列表集合—
top_result.top_creative_v_o.creative_list[].media_material_list[].creative_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].creative_idNumber官方未标注必填广告创意编号6843262308
top_result.top_creative_v_o.creative_list[].media_material_list[].format样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].formatNumber官方未标注必填业务字段 format2
top_result.top_creative_v_o.creative_list[].media_material_list[].start_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].start_timeDate官方未标注必填查询或投放起始时间2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].media_material_list[].end_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].end_timeDate官方未标注必填查询或投放结束时间2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].media_material_list[].effective_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].effective_timeDate官方未标注必填业务字段 effective_time2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].media_material_list[].expire_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].expire_timeDate官方未标注必填业务字段 expire_time2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].media_material_list[].material_name样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_nameString官方未标注必填素材名称宝贝xxx名称
top_result.top_creative_v_o.creative_list[].media_material_list[].outer_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].outer_idNumber官方未标注必填业务对象标识1011
top_result.top_creative_v_o.creative_list[].media_material_list[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].sourceNumber官方未标注必填请求来源标识1
top_result.top_creative_v_o.creative_list[].media_material_list[].tag样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].tagString官方未标注必填业务字段 tagtag名称
top_result.top_creative_v_o.creative_list[].media_material_list[].item_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].item_idNumber官方未标注必填商品编号6843262308
top_result.top_creative_v_o.creative_list[].media_material_list[].image_position样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_positionNumber官方未标注必填业务字段 image_position1
top_result.top_creative_v_o.creative_list[].media_material_list[].image_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_pathString官方未标注必填业务字段 image_pathhttp://localhost
top_result.top_creative_v_o.creative_list[].media_material_list[].video_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_idNumber官方未标注必填视频标识1012
top_result.top_creative_v_o.creative_list[].media_material_list[].video_image_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_image_pathString官方未标注必填业务字段 video_image_pathhttp://localhost
top_result.top_creative_v_o.creative_list[].media_material_list[].video_path样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_pathString官方未标注必填业务字段 video_pathhttp://localhost
top_result.top_creative_v_o.creative_list[].media_material_list[].width样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].widthNumber官方未标注必填业务字段 width200
top_result.top_creative_v_o.creative_list[].media_material_list[].height样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].heightNumber官方未标注必填业务字段 height400
top_result.top_creative_v_o.creative_list[].media_material_list[].sync_key样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].sync_keyString官方未标注必填业务字段 sync_keyxxxxx
top_result.top_creative_v_o.creative_list[].media_material_list[].image_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_idNumber官方未标注必填图片标识101
top_result.top_creative_v_o.creative_list[].media_material_list[].material_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_typeString官方未标注必填素材类型title
top_result.top_creative_v_o.creative_list[].media_material_list[].material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_idNumber官方未标注必填素材标识714894818852
top_result.top_creative_v_o.creative_list[].media_material_list[].haitang_source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].haitang_sourceNumber官方未标注必填业务字段 haitang_source1
top_result.top_creative_v_o.creative_list[].title_material_list样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_listTextMaterialInfoVO []官方未标注必填含下级字段素材列表集合—
top_result.top_creative_v_o.creative_list[].title_material_list[].creative_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].creative_idNumber官方未标注必填广告创意编号6843262308
top_result.top_creative_v_o.creative_list[].title_material_list[].material_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_idNumber官方未标注必填素材标识714894818852
top_result.top_creative_v_o.creative_list[].title_material_list[].item_id样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].item_idNumber官方未标注必填商品编号6843262308
top_result.top_creative_v_o.creative_list[].title_material_list[].start_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].start_timeDate官方未标注必填查询或投放起始时间2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].title_material_list[].end_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].end_timeDate官方未标注必填查询或投放结束时间2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].title_material_list[].effective_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].effective_timeDate官方未标注必填业务字段 effective_time2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].title_material_list[].expire_time样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].expire_timeDate官方未标注必填业务字段 expire_time2024-01-01 00:00:00
top_result.top_creative_v_o.creative_list[].title_material_list[].content_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].content_typeString官方未标注必填内容类型title
top_result.top_creative_v_o.creative_list[].title_material_list[].content样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].contentString官方未标注必填内容xxxxxx
top_result.top_creative_v_o.creative_list[].title_material_list[].material_type样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_typeString官方未标注必填素材类型title
top_result.top_creative_v_o.creative_list[].title_material_list[].source样例 JSON:universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].sourceNumber官方未标注必填请求来源标识2
top_result.top_creative_v_o.creative_list[].report_info_mapString官方未标注必填业务字段 report_info_map—

字段核对说明

  • 部分响应字段未出现在官方 JSON 示例中;wirePath 为 null 时请依实际返回核对。

Python 签名直连示例

下载 qimenyun_direct.py 与业务脚本放在同一目录,保留淘宝业务参数,使用奇门云密钥和 shopKey 申请签名,由客户服务器直接请求淘宝。运行前补全业务参数,无需自行计算平台签名。

# Python 3.9+,无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名,再由本程序直接请求淘宝;业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥:").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.creative.add\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_command_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey:").strip()

# 此接口会修改业务数据,请核对店铺、目标对象及金额。
print("即将执行:", body["method"], "店铺:", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM:").strip() != "CONFIRM":
    raise SystemExit("已取消,未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时,先查询实际状态。

判断成功与失败

签名阶段先检查 HTTP 状态;本站鉴权、套餐或授权失败返回 {ok:false,error:{code,message}}。签名 HTTP 200 仅说明已签发;客户端执行官方请求后,还要检查淘宝响应的 error_response、逐项错误和 top_result.info.ok;失败不能当成空列表。

执行阶段的淘宝原始 error_response、业务 info 和 request_id 直接返回客户服务器,不由奇门云统一包装。签名和授权由本站管理,业务参数、日期、分页及平台资格按淘宝原始错误排查。

  • error_response:TOP 网关错误;应读取错误码及细分错误码,不能按空结果处理。
  • top_result.info:HTTP 成功仍须核对业务 ok;false 表示业务未完成。

下载本页 MD 可交给开发人员或 AI,密钥只填在自己的私密配置中。