接口参考 · 修改操作
保存创意和模板信息
taobao.universalbp.new.creative.updatecreativeandtemplate
核对日期: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.updatecreativeandtemplate",
"params": {
"top_service_context": {
"biz_code": "universalBP",
"login_type": 1,
"ext": "{}"
},
"creative_and_template_list_v_o": {}
}
}这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。
请求业务参数
以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。
官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_service_context | TopServiceContext必填含下级字段 | 推广业务上下文 | — |
top_service_context.biz_code | String必填 | 推广场景标识 | xxxxx |
top_service_context.login_type | Number可选 | 账户登录方式枚举:1、2=代理直投(叉乘账号) | 1 |
top_service_context.member_id | Number可选 | 广告账户标识代理直投(叉乘)时必填 | 12345 |
top_service_context.ext | String可选 | 扩展参数 | {} |
creative_and_template_list_v_o | CreativeAndTemplateListVO必填含下级字段 | 创意模板列表对象 | — |
creative_and_template_list_v_o.creative_and_template_list | CreativeAndTemplateCommandVO []必填含下级字段 | 创意模板列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign | CampaignCommandVO可选含下级字段 | 计划 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_biz_code | String可选 | 业务字段 campaign_biz_code | onebpDisplay |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.top_status | Boolean可选 | 是否置顶枚举:true=置顶、false=不置顶 | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_group_id | Number可选 | 计划标识计划组已经存在场景必填 | 25481004 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_name | String可选 | 推广计划名称 | 管家计划_宝贝候选集 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_model | String可选 | 业务字段 campaign_model | daily:持续推广,order:套餐包 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_model | String可选 | 业务字段 promotion_model | daily:持续推广,order:套餐包 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_scene | String可选 | 业务字段 promotion_scene枚举: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) | promotion_scene_crowd |
creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_goals | String可选 | 业务字段 promotion_goals枚举:shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd |
creative_and_template_list_v_o.creative_and_template_list[].campaign.optimize_target | String可选 | 优化目标枚举: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=旺旺留资 | conv |
creative_and_template_list_v_o.creative_and_template_list[].campaign.dmc_type | String可选 | 预算方式标识枚举:normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
creative_and_template_list_v_o.creative_and_template_list[].campaign.day_budget | Number可选 | 日预算 | 100 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.smooth_option | String可选 | 每日预算投放节奏枚举:quick=天内尽快、smooth=天内平滑 | smooth |
creative_and_template_list_v_o.creative_and_template_list[].campaign.total_budget | Number可选 | 累计预算 | 100 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.budget_period | Number可选 | 业务字段 budget_period | 7 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.period_smooth | String可选 | 业务字段 period_smooth枚举:quick=天内尽快、smooth=天内平滑 | smooth |
creative_and_template_list_v_o.creative_and_template_list[].campaign.bid_type | String可选 | 出价类型枚举:custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc | CampaignOcpcCommandVO可选含下级字段 | 计划对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc.enable_ocpc | Boolean可选 | 业务字段 enable_ocpc枚举:true=是、false=否 | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc.ocpc_ratio | Number可选 | 业务字段 ocpc_ratio | 200 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.constraint_type | String可选 | 业务字段 constraint_type枚举:non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.constraint_value | String可选 | 业务字段 constraint_value | 3 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.cold_boot | Number可选 | 业务字段 cold_boot枚举:0=否、1=是 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_and_template_list_v_o.creative_and_template_list[].campaign.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_and_template_list_v_o.creative_and_template_list[].campaign.sub_promotion_type_list | String []可选 | 类型集合 | ["item"] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_type_list | String []可选 | 类型集合 | ["item"] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.item_selected_mode | String可选 | 业务字段 item_selected_mode枚举:shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
creative_and_template_list_v_o.creative_and_template_list[].campaign.item_rec_strategy_list | String []可选 | 商品集合 | ["effect_gmv","effect_coll"] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.shop_item_type | String可选 | 店铺商品类型枚举:effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_items | Number []可选 | 业务字段 shield_items | [714707465203, 714901906337] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.scope_items | Number []可选 | 业务字段 scope_items | [714707465203, 714901906337] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.main_pic_video | String可选 | 业务字段 main_pic_video | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.auto_wang_wang_pic | String可选 | 业务字段 auto_wang_wang_pic | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.creative_optimization | String可选 | 业务字段 creative_optimization枚举:black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | black_creative |
creative_and_template_list_v_o.creative_and_template_list[].campaign.creative_set_mode | String可选 | 业务字段 creative_set_mode枚举:minimalist=极简版、professional=专业版 | professional |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_area_str_list | String []可选 | 地域集合 | ["1","19"] 或者 ["all"] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time | CampaignLaunchTimeCommandVO可选含下级字段 | 时间对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.start_time | Date可选 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.end_time | Date可选 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.launch_forever | Boolean可选 | 业务字段 launch_forever枚举:true=是、false=否 | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories | CategoryCommandVO []可选含下级字段 | 业务集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories[].cat_id | Number可选 | 业务对象标识 | 35 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories[].cat_name | String可选 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list | TrendThemeCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list[].trend_theme_id | Number可选 | 业务对象标识 | 566987194 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list[].trend_theme_name | String可选 | 业务字段 trend_theme_name | 无边发光字 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_type | String可选 | 业务字段 launch_period_type | xxxxx |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list | CampaignLaunchPeriodCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].day_of_week | Number可选 | 业务字段 day_of_week | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list | TimeSpanVO []可选含下级字段 | 时间列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list[].discount | Number可选 | 出价溢价 | 100 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list[].time | String可选 | 时间 | 00:00-24:00 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail | CampaignMiniDetailCommandVO可选含下级字段 | 业务对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.mini_detail_theme | String可选 | 业务字段 mini_detail_theme枚举:1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_item_id_list | Number []可选 | 商品标识集合 | [714707465203, 714901906337] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_top_item_id_list | Number []可选 | 商品标识集合 | [714707465203] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_type | Number可选 | 业务字段 private_mini_type枚举:0=黑名单、1=白名单 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list | CampaignCrowdFilterVO []可选含下级字段 | 人群列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list[].behavior | String可选 | 业务字段 behavior枚举:purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list[].window | String可选 | 业务字段 window枚举:7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list | CampaignBrandFilterVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list[].brand_id | String可选 | 业务对象标识 | 20067 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list[].deeplink_list | String []可选 | 业务条件集合枚举:Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list | DeeplinkBrandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list[].deeplink_brand_id | String可选 | 业务对象标识 | 20067 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list[].deeplink_brand_name | String可选 | 业务字段 deeplink_brand_name | Lancome/兰蔻 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list | CampaignGenderAgeFilterVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list[].gender | String可选 | 业务字段 gender枚举:man=男性人群、woman=女性人群 | man |
creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list[].age_list | String []可选 | 业务条件集合枚举:0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] |
creative_and_template_list_v_o.creative_and_template_list[].campaign.category_crowd_type | String可选 | 业务字段 category_crowd_type枚举:0=全域拉新、1=同类目拉新、2=跨类目拉新、7=OAI人群 | 0 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list | AdzoneRefCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].adzone_id | Number可选 | 业务对象标识 | 111287850198 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].discount | Number可选 | 出价溢价 | 3 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].status | String可选 | 状态标识枚举:start=投放、pause=暂停 | start |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list | CrowdRefCommandVO []可选含下级字段 | 人群列表 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68799007001 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68796878061 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].online_status | Number可选 | 投放上下线状态枚举:0、1=上线 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd | CrowdCommandVO可选含下级字段 | 人群 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 目标人群扩展 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_value | String可选 | 人群值 | 2191820003 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.target_type | Number可选 | 目标类型 | 130 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label | LabelCommandVO可选含下级字段 | 定向标签 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.target_type | Number可选 | 目标类型 | 131 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_desc | String可选 | 业务字段 label_desc | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_value | String可选 | 定向标签值 | 2000112 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list | OptionCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].properties | String可选 | 扩展属性内容 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.properties | String可选 | 扩展属性内容 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.target_value | Number可选 | 目标值 | 11111 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.lookalike_multiple | String可选 | 业务字段 lookalike_multiple | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO []可选含下级字段 | 人群列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO可选含下级字段 | 人群 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number可选 | 人群标识 | 5536708993 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 喜欢店铺新品的访客 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO可选含下级字段 | 定向标签 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price | PriceCommandVO可选含下级字段 | 金额 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price.bid_price | String可选 | 出价金额 | 30 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price.discount | String可选 | 出价溢价 | 30 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.target_crowd | String可选 | 目标人群枚举:ShopNew=店铺新客、brandNew=品牌新客 | ShopNew |
creative_and_template_list_v_o.creative_and_template_list[].campaign.scene_target | String可选 | 业务字段 scene_target枚举:InShopNew=新客访问、InterestNew=新客兴趣加深、BuyNew=新客成交 | BuyNew |
creative_and_template_list_v_o.creative_and_template_list[].campaign.source_channel | String可选 | 业务字段 source_channel | adStrategyDurationPC |
creative_and_template_list_v_o.creative_and_template_list[].campaign.speed_type | String可选 | 业务字段 speed_type | smooth |
creative_and_template_list_v_o.creative_and_template_list[].campaign.exposure_time | Number可选 | 业务字段 exposure_time | 2 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.plan_id | Number可选 | 业务对象标识 | 260699 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.auto_renewal | Boolean可选 | 业务字段 auto_renewal | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info | CampaignOrderInfoVO可选含下级字段 | 业务对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.plan_id | Number可选 | 业务对象标识 | 260699 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.plan_name | String可选 | 业务字段 plan_name | 测试 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.order_amount | String可选 | 业务字段 order_amount | 0.01 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.max_period | Number可选 | 业务字段 max_period | 30 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.min_period | Number可选 | 业务字段 min_period | 3 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.total_stock | Number可选 | 业务字段 total_stock | 30 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO可选含下级字段 | 预算操作对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command.quick_lift_switch | Boolean可选 | 业务字段 quick_lift_switch | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command.quick_lift_budget_version | String可选 | 业务字段 quick_lift_budget_version | 1 |
creative_and_template_list_v_o.creative_and_template_list[].campaign.is_budget_schedule_open | Boolean可选 | 业务字段 is_budget_schedule_open | true |
creative_and_template_list_v_o.creative_and_template_list[].campaign.market_aim_type | String可选 | 业务字段 market_aim_type枚举:fixed_target=固定目标、auto_trans=自动流转 | fixed_target |
creative_and_template_list_v_o.creative_and_template_list[].campaign.smart_creative | Number可选 | 业务字段 smart_creative | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list | AdgroupCommandVO []可选含下级字段 | 单元列表 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68793666608 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material | AdgroupMaterialCommandVO可选含下级字段 | 素材 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.material_id | Number可选 | 素材标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.material_name | String可选 | 素材名称 | yiliantest测试请不要拍22 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.link_url | String可选 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String可选 | 业务字段 life_cycle_desc | 新品打爆期 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].color | String可选 | 业务字段 color | #36A2FC |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].tips | String可选 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].type | Number可选 | 类型 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list | CrowdRefCommandVO []可选含下级字段 | 人群列表 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68799007001 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68796878061 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].online_status | Number可选 | 投放上下线状态枚举:0、1=上线 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd | CrowdCommandVO可选含下级字段 | 人群 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_id | Number可选 | 人群标识人群已经存在场景必填 | 5526396502 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 目标人群扩展 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_value | String可选 | 人群值 | 2191820003 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.target_type | Number可选 | 目标类型 | 130 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label | LabelCommandVO可选含下级字段 | 定向标签 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.target_type | Number可选 | 目标类型 | 131 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_desc | String可选 | 业务字段 label_desc | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_value | String可选 | 定向标签值 | 2000112 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String可选 | 扩展属性内容 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.properties | String可选 | 扩展属性内容 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties可选含下级字段 | 定向标签对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String可选 | 业务对象标识 | 1001 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String可选 | 业务字段 cate_name | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String可选 | 业务对象标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.target_value | Number可选 | 目标值 | 11111 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.lookalike_multiple | String可选 | 业务字段 lookalike_multiple | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO []可选含下级字段 | 人群列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO可选含下级字段 | 人群 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number可选 | 人群标识 | 5536708993 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String可选 | 人群名称 | 喜欢店铺新品的访客 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO可选含下级字段 | 定向标签 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number可选 | 定向标签标识 | 3000494 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String可选 | 定向标签名称 | 关键词 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String可选 | 业务字段 option_name | 人群特征继承 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String可选 | 业务字段 option_value | 2000123 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number可选 | 业务对象标识 | 100000 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price | PriceCommandVO可选含下级字段 | 金额 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price.bid_price | String可选 | 出价金额 | 30 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price.discount | String可选 | 出价溢价 | 30 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list | WordCommandVO []可选含下级字段 | 词列表 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].bidword_id | Number可选 | 关键词标识关键词已经存在场景必填 | 1124844766581 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68793666608 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].word | String可选 | 词 | 鞋原创小众 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].bid_price | String可选 | 出价金额 | 2.23 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].online_status | Number可选 | 投放上下线状态枚举:1=在线、0=下线 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].match_scope | Number可选 | 业务字段 match_scope枚举:1=精准匹配、4=广泛匹配 | 4 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list | WordPackageCommandVO []可选含下级字段 | 词列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68793666608 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_id | Number可选 | 词标识词包已经存在场景必填 | 38577 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_name | String可选 | 业务字段 word_package_name | 流量智选 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_type | Number可选 | 业务字段 word_package_type枚举:0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].status | Number可选 | 状态标识枚举:1=在线、0=下线 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].bid_price | String可选 | 出价金额 | 5 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO []可选含下级字段 | 列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number可选 | 业务对象标识枚举:0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].online_status | Number可选 | 投放上下线状态枚举:1=在线、0=下线 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].bid_price | String可选 | 出价金额 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].dynamic_title_flag | String可选 | 业务字段 dynamic_title_flag | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO可选含下级字段 | 单元对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean可选 | 业务字段 enable_ocpc枚举:true=是、false=否 | true |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.ocpc_ratio | Number可选 | 业务字段 ocpc_ratio | 200 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String可选 | 业务字段 ocpc_marketing_aim枚举:conv=促进成交、coll_cart=促进加购、click=促进点击、new_item=新品冷启动、new_ad=新广告加速、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、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=提高成交量 | click |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative | Number可选 | 业务字段 smart_creative | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info | CreativeRefCommandVO可选含下级字段 | 创意对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.adgroup_id | Number可选 | 推广单元编号单元已经存在场景必填 | 68793666608 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.creative_id | Number可选 | 广告创意编号 | 6845715605 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.creative_id_list | Number []可选 | 创意标识列表 | [739684500310001] |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.add_main_pic_video | Boolean可选 | 业务字段 add_main_pic_video枚举:true=是、false=否 | true |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.add_auto_creative | Boolean可选 | 业务字段 add_auto_creative枚举:true=是、false=否 | true |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO []可选含下级字段 | 素材图片列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].material_id | Number可选 | 素材标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].sync_key | String可选 | 业务字段 sync_key | xxxx |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_position | Number可选 | 业务字段 image_position | 0 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].img_url | String可选 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].link_url | String可选 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].material_name | String可选 | 素材名称 | 外投宝贝测试,请不要拍 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_id | Number可选 | 图片标识 | 101 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].size | String可选 | 业务字段 size | 800*800 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].width | Number可选 | 业务字段 width | 800 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].height | Number可选 | 业务字段 height | 800 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_properties | String可选 | 业务字段 image_properties | xxxxx |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list | CreativeCommandVO []可选含下级字段 | 创意列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_id | Number可选 | 广告创意编号 | 6843262308 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_name | String可选 | 广告创意名称 | sss |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].source | Number可选 | 请求来源标识枚举:1=本地上传、3=CreativeCenter | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].tp_format | Number可选 | 业务字段 tp_format枚举:2=图片、10=创意模板、12=微视频 | 2 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].start_time | String可选 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].end_time | String可选 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title | String可选 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].image_path | String可选 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].click_url | String可选 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_id | Number可选 | 视频标识 | 398436114008 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_protection | Number可选 | 业务字段 creative_protection | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_duration | String可选 | 业务字段 video_duration | 10 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_path | String可选 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_image_path | String可选 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO []可选含下级字段 | 素材列表 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number可选 | 素材标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number可选 | 视频标识 | 398436114008 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].source | Number可选 | 请求来源标识枚举:1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number可选 | 业务对象标识 | 989898 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].format_type | Number可选 | 业务字段 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_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].url | String可选 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String可选 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_size | String可选 | 业务字段 creative_size | 513x750 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO可选含下级字段 | 创意对象 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number可选 | 业务对象标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO可选含下级字段 | 素材 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number可选 | 素材标识 | 714616513841 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.img_url | String可选 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String可选 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String可选 | 素材名称 | yiliantest测试请不要拍22 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String可选 | 展示标题 | yiliantest测试请不要拍22 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].template_data | String可选 | 业务字段 template_data | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].js_in_html | String可选 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].outer_id | Number可选 | 业务对象标识 | 225349579 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_center_id | String可选 | 创意标识 | 225349579 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].item_id_list | Number []可选 | 商品标识列表 | [679056995041] |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String []可选 | 类型集合枚举:1=PC、2=无线、3=PC和无线 | [1] |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].tab_type | String可选 | 业务字段 tab_type | 2 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].template_id | Number可选 | 模板标识 | 2000000000 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].campaign_id | Number可选 | 推广计划编号 | 68796878069 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].adgroup_id | Number可选 | 推广单元编号 | 68793666608 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].is_clip | Boolean可选 | 业务字段 is_clip枚举:true=是、false=否 | false |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_group_id | Number可选 | 素材标识 | 1010 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO []可选含下级字段 | 素材列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number可选 | 广告创意编号 | 6843262308 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number可选 | 业务字段 tp_format | 2 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date可选 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date可选 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date可选 | 业务字段 effective_time | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date可选 | 业务字段 expire_time | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String可选 | 素材名称 | 宝贝xxx名称 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number可选 | 业务对象标识 | 1011 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number可选 | 请求来源标识 | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String可选 | 业务字段 tag | tag名称 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number可选 | 商品编号 | 6843262308 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number可选 | 业务字段 image_position | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String可选 | 业务字段 image_path | http://localhost |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number可选 | 视频标识 | 1012 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String可选 | 业务字段 video_image_path | http://localhost |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String可选 | 业务字段 video_path | http://localhost |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number可选 | 业务字段 width | 200 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number可选 | 业务字段 height | 400 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String可选 | 业务字段 sync_key | xxxxx |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number可选 | 图片标识 | 101 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String可选 | 素材类型 | title |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number可选 | 素材标识 | 714894818852 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number可选 | 业务字段 haitang_source | 1 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO []可选含下级字段 | 素材列表集合 | — |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number可选 | 广告创意编号 | 6843262308 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number可选 | 素材标识 | 714894818852 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number可选 | 商品编号 | 6843262308 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date可选 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date可选 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date可选 | 业务字段 effective_time | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date可选 | 业务字段 expire_time | 2024-01-01 00:00:00 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String可选 | 内容类型 | title |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content | String可选 | 内容 | xxxxxx |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String可选 | 素材类型 | title |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number可选 | 请求来源标识 | 2 |
creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_type | Number可选 | 创意类型 | 20 |
返回业务字段
响应外层为 universalbp_new_creative_updatecreativeandtemplate_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_result样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result | TopResult官方未标注必填含下级字段 | 接口业务结果 | — |
top_result.info样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.info | TopInfo官方未标注必填含下级字段 | 执行状态信息 | — |
top_result.info.ok样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.info.ok | Boolean官方未标注必填 | 业务是否成功 | true |
top_result.info.message样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.info.message | String官方未标注必填 | 业务结果提示 | 参数错误 |
top_result.info.error_code样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.info.error_code | String官方未标注必填 | 业务错误标识 | xxxxx |
top_result.creative_and_template_result_v_o_top_part_data样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data | TopPartData官方未标注必填含下级字段 | 创意模板结果对象 | — |
top_result.creative_and_template_result_v_o_top_part_data.count样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.count | Number官方未标注必填 | 结果计数 | 10 |
top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list | CreativeAndTemplateResultVO []官方未标注必填含下级字段 | 创意模板结果列表集合 | — |
top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list[].campaign_id样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list.creative_and_template_result_v_o[].campaign_id | Number官方未标注必填 | 推广计划编号计划已经存在场景必填 | 68796878069 |
top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list[].adgroup_id样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list.creative_and_template_result_v_o[].adgroup_id | Number官方未标注必填 | 推广单元编号 | 68793666608 |
top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list[].material_id样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.creative_and_template_result_v_o_list.creative_and_template_result_v_o[].material_id | Number官方未标注必填 | 素材标识 | 714616513841 |
top_result.creative_and_template_result_v_o_top_part_data.error_count样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.error_count | Number官方未标注必填 | 失败项数 | 10 |
top_result.creative_and_template_result_v_o_top_part_data.error_details样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.error_details | TopFailResult []官方未标注必填含下级字段 | 逐项失败明细 | — |
top_result.creative_and_template_result_v_o_top_part_data.error_details[].code样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.error_details.top_fail_result[].code | String官方未标注必填 | 结果或业务代码 | xxxxx |
top_result.creative_and_template_result_v_o_top_part_data.error_details[].msg样例 JSON:universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.error_details.top_fail_result[].msg | String官方未标注必填 | 结果提示 | xxxxx |
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.updatecreativeandtemplate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_and_template_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 表示业务未完成。top_result.creative_and_template_result_v_o_top_part_data.error_details:批量操作可逐项失败,应核对失败计数和明细。
下载本页 MD 可交给开发人员或 AI,密钥只填在自己的私密配置中。