# 更新计划基础属性

`taobao.universalbp.new.campaign.updatepart`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=68716)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 本站调用约定

- 签名地址：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检查官方更新，经核对验证后同步，不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈，不误判为平台权限不足。

## 请求业务字段

路径均位于本站 JSON 的 params 内。必填列保留官方标注；官方未标注的内容不推定为必填或可选。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| 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 | 否 | 扩展参数 | {} |
| campaign_update_part_list_v_o | CampaignUpdatePartListVO | 是 | 计划列表对象 | — |
| campaign_update_part_list_v_o.campaign_list | CampaignUpdatePartCommandVO [] | 是 | 计划列表 | — |
| campaign_update_part_list_v_o.campaign_list[].campaign_id | Number | 是 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_update_part_list_v_o.campaign_list[].display_status | String | 否 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause |
| campaign_update_part_list_v_o.campaign_list[].campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| campaign_update_part_list_v_o.campaign_list[].launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| campaign_update_part_list_v_o.campaign_list[].top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| campaign_update_part_list_v_o.campaign_list[].launch_period_type | String | 否 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | true |
| campaign_update_part_list_v_o.campaign_list[].day_budget | Number | 否 | 日预算 | 499 |
| campaign_update_part_list_v_o.campaign_list[].total_budget | Number | 否 | 累计预算 | 350 |
| campaign_update_part_list_v_o.campaign_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_update_part_list_v_o.campaign_list[].constraint_type | String | 否 | 业务字段 constraint_type | roi |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| campaign_update_part_list_v_o.campaign_list[].dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| campaign_update_part_list_v_o.campaign_list[].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=旺旺留资 | live_view_count |
| campaign_update_part_list_v_o.campaign_list[].promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| campaign_update_part_list_v_o.campaign_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| campaign_update_part_list_v_o.campaign_list[].budget_period | Number | 否 | 业务字段 budget_period | 7 |
| campaign_update_part_list_v_o.campaign_list[].auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| campaign_update_part_list_v_o.campaign_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_update_part_list_v_o.campaign_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_update_part_list_v_o.campaign_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| campaign_update_part_list_v_o.campaign_list[].smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | quick |
| campaign_update_part_list_v_o.campaign_list[].period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | quick |
| campaign_update_part_list_v_o.campaign_list[].search_detent_type | String | 否 | 业务字段 search_detent_type | first_place |
| campaign_update_part_list_v_o.campaign_list[].algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all |

## 响应业务字段

官方样例未能核实响应外层，以下保留业务字段结构，实际 JSON 路径请以接口返回和官方说明为准。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | — |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | — |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | — |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | — |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | — |
| top_result.campaign_v_o_top_part_data | TopPartData | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].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 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].market_scene | String | 未标注 | 业务字段 market_scene | wxt_live_max_view :最大化拿量 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].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 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].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 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].speed_type | String | 未标注 | 业务字段 speed_type | xxxxx | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_type | String | 未标注 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].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] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].common_filter | String | 未标注 | 业务字段 common_filter | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].common_filters | String | 未标注 | 业务字段 common_filters | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scene_id | Number | 未标注 | 业务对象标识 | promotion_scene_item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | — |
| top_result.campaign_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | — |
| top_result.campaign_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | — |
| top_result.campaign_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.error_details[].result | CampaignVO | 未标注 | 执行结果内容 | — | — |
| top_result.campaign_v_o_top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | — |
| top_result.campaign_v_o_top_part_data.error_details[].result.campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |

## 核对备注

- 官方响应示例没有可核实的 JSON 外层对象，未推测 wirePath。

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

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.updatepart",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_update_part_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# 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.campaign.updatepart\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_update_part_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
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.campaign_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。

来源校验 SHA256：eff1a168a83aaf2ac3b5c97a4b657bf0044f14021e54b9c714b31ee120813d1f

