# 批量添加单元或主体

`taobao.universalbp.new.adgroup.addlist`

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

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

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

## 本站调用约定

- 签名地址：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 | 否 | 扩展参数 | {} |
| adgroup_add_command_v_o | AdgroupAddCommandVO | 是 | 单元操作对象 | — |
| adgroup_add_command_v_o.campaign | CampaignCommandVO | 是 | 计划 | — |
| adgroup_add_command_v_o.campaign.campaign_biz_code | String | 否 | 业务字段 campaign_biz_code | onebpDisplay |
| adgroup_add_command_v_o.campaign.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.campaign.top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| adgroup_add_command_v_o.campaign.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| adgroup_add_command_v_o.campaign.campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| adgroup_add_command_v_o.campaign.campaign_model | String | 否 | 业务字段 campaign_model | daily:持续推广,order:套餐包 |
| adgroup_add_command_v_o.campaign.promotion_model | String | 否 | 业务字段 promotion_model | daily:持续推广,order:套餐包 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.campaign.promotion_goals | String | 否 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.campaign.dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| adgroup_add_command_v_o.campaign.day_budget | Number | 否 | 日预算 | 100 |
| adgroup_add_command_v_o.campaign.smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| adgroup_add_command_v_o.campaign.total_budget | Number | 否 | 累计预算 | 100 |
| adgroup_add_command_v_o.campaign.budget_period | Number | 否 | 业务字段 budget_period | 7 |
| adgroup_add_command_v_o.campaign.period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| adgroup_add_command_v_o.campaign.bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| adgroup_add_command_v_o.campaign.campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| adgroup_add_command_v_o.campaign.campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.campaign.campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| adgroup_add_command_v_o.campaign.constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| adgroup_add_command_v_o.campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| adgroup_add_command_v_o.campaign.cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| adgroup_add_command_v_o.campaign.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.campaign.sub_promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| adgroup_add_command_v_o.campaign.promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| adgroup_add_command_v_o.campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| adgroup_add_command_v_o.campaign.item_rec_strategy_list | String [] | 否 | 商品集合 | ["effect_gmv","effect_coll"] |
| adgroup_add_command_v_o.campaign.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| adgroup_add_command_v_o.campaign.shield_items | Number [] | 否 | 业务字段 shield_items | [714707465203, 714901906337] |
| adgroup_add_command_v_o.campaign.scope_items | Number [] | 否 | 业务字段 scope_items | [714707465203, 714901906337] |
| adgroup_add_command_v_o.campaign.main_pic_video | String | 否 | 业务字段 main_pic_video | 1 |
| adgroup_add_command_v_o.campaign.auto_wang_wang_pic | String | 否 | 业务字段 auto_wang_wang_pic | 1 |
| adgroup_add_command_v_o.campaign.creative_optimization | String | 否 | 业务字段 creative_optimization；枚举：black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | black_creative |
| adgroup_add_command_v_o.campaign.creative_set_mode | String | 否 | 业务字段 creative_set_mode；枚举：minimalist=极简版、professional=专业版 | professional |
| adgroup_add_command_v_o.campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["1","19"] 或者 ["all"] |
| adgroup_add_command_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| adgroup_add_command_v_o.campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| adgroup_add_command_v_o.campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| adgroup_add_command_v_o.campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.campaign.shield_categories | CategoryCommandVO [] | 否 | 业务集合 | — |
| adgroup_add_command_v_o.campaign.shield_categories[].cat_id | Number | 否 | 业务对象标识 | 35 |
| adgroup_add_command_v_o.campaign.shield_categories[].cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| adgroup_add_command_v_o.campaign.trend_theme_list | TrendThemeCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.trend_theme_list[].trend_theme_id | Number | 否 | 业务对象标识 | 566987194 |
| adgroup_add_command_v_o.campaign.trend_theme_list[].trend_theme_name | String | 否 | 业务字段 trend_theme_name | 无边发光字 |
| adgroup_add_command_v_o.campaign.launch_period_type | String | 否 | 业务字段 launch_period_type | xxxxx |
| adgroup_add_command_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| adgroup_add_command_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| adgroup_add_command_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| adgroup_add_command_v_o.campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| adgroup_add_command_v_o.campaign.spot_continue | Number | 否 | 业务字段 spot_continue | 1 |
| adgroup_add_command_v_o.campaign.mini_detail | CampaignMiniDetailCommandVO | 否 | 业务对象 | — |
| adgroup_add_command_v_o.campaign.mini_detail.mini_detail_theme | String | 否 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 |
| adgroup_add_command_v_o.campaign.mini_detail.private_mini_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203, 714901906337] |
| adgroup_add_command_v_o.campaign.mini_detail.private_mini_top_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203] |
| adgroup_add_command_v_o.campaign.mini_detail.private_mini_type | Number | 否 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 |
| adgroup_add_command_v_o.campaign.crowd_filter_list | CampaignCrowdFilterVO [] | 否 | 人群列表集合 | — |
| adgroup_add_command_v_o.campaign.crowd_filter_list[].behavior | String | 否 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
| adgroup_add_command_v_o.campaign.crowd_filter_list[].window | String | 否 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
| adgroup_add_command_v_o.campaign.brand_filter_list | CampaignBrandFilterVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.brand_filter_list[].brand_id | String | 否 | 业务对象标识 | 20067 |
| adgroup_add_command_v_o.campaign.brand_filter_list[].deeplink_list | String [] | 否 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] |
| adgroup_add_command_v_o.campaign.deeplink_brand_list | DeeplinkBrandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.deeplink_brand_list[].deeplink_brand_id | String | 否 | 业务对象标识 | 20067 |
| adgroup_add_command_v_o.campaign.deeplink_brand_list[].deeplink_brand_name | String | 否 | 业务字段 deeplink_brand_name | Lancome/兰蔻 |
| adgroup_add_command_v_o.campaign.gender_age_filter_list | CampaignGenderAgeFilterVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.gender_age_filter_list[].gender | String | 否 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man |
| adgroup_add_command_v_o.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] |
| adgroup_add_command_v_o.campaign.category_crowd_type | String | 否 | 业务字段 category_crowd_type；枚举：0=全域拉新、1=同类目拉新、2=跨类目拉新、7=OAI人群 | 0 |
| adgroup_add_command_v_o.campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| adgroup_add_command_v_o.campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| adgroup_add_command_v_o.campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| adgroup_add_command_v_o.campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| adgroup_add_command_v_o.campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| adgroup_add_command_v_o.campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| adgroup_add_command_v_o.campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| adgroup_add_command_v_o.campaign.extend_crowd | CrowdRefCommandVO | 否 | 人群对象 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| adgroup_add_command_v_o.campaign.extend_crowd.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.extend_crowd.online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd | CrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.target_type | Number | 否 | 目标类型 | 130 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.price | PriceCommandVO | 否 | 金额 | — |
| adgroup_add_command_v_o.campaign.extend_crowd.price.bid_price | String | 否 | 出价金额 | 30 |
| adgroup_add_command_v_o.campaign.extend_crowd.price.discount | String | 否 | 出价溢价 | 30 |
| adgroup_add_command_v_o.campaign.target_crowd | String | 否 | 目标人群；枚举：ShopNew=店铺新客、brandNew=品牌新客 | ShopNew |
| adgroup_add_command_v_o.campaign.scene_target | String | 否 | 业务字段 scene_target；枚举：InShopNew=新客访问、InterestNew=新客兴趣加深、BuyNew=新客成交 | BuyNew |
| adgroup_add_command_v_o.campaign.source_channel | String | 否 | 业务字段 source_channel | adStrategyDurationPC |
| adgroup_add_command_v_o.campaign.speed_type | String | 否 | 业务字段 speed_type | smooth |
| adgroup_add_command_v_o.campaign.exposure_time | Number | 否 | 业务字段 exposure_time | 2 |
| adgroup_add_command_v_o.campaign.plan_id | Number | 否 | 业务对象标识 | 260699 |
| adgroup_add_command_v_o.campaign.auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| adgroup_add_command_v_o.campaign.order_info | CampaignOrderInfoVO | 否 | 业务对象 | — |
| adgroup_add_command_v_o.campaign.order_info.plan_id | Number | 否 | 业务对象标识 | 260699 |
| adgroup_add_command_v_o.campaign.order_info.plan_name | String | 否 | 业务字段 plan_name | 测试 |
| adgroup_add_command_v_o.campaign.order_info.order_amount | String | 否 | 业务字段 order_amount | 0.01 |
| adgroup_add_command_v_o.campaign.order_info.max_period | Number | 否 | 业务字段 max_period | 30 |
| adgroup_add_command_v_o.campaign.order_info.min_period | Number | 否 | 业务字段 min_period | 3 |
| adgroup_add_command_v_o.campaign.order_info.total_stock | Number | 否 | 业务字段 total_stock | 30 |
| adgroup_add_command_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| adgroup_add_command_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch | true |
| adgroup_add_command_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| adgroup_add_command_v_o.campaign.is_budget_schedule_open | Boolean | 否 | 业务字段 is_budget_schedule_open | true |
| adgroup_add_command_v_o.campaign.market_aim_type | String | 否 | 业务字段 market_aim_type；枚举：fixed_target=固定目标、auto_trans=自动流转 | fixed_target |
| adgroup_add_command_v_o.campaign.search_detent_type | String | 否 | 业务字段 search_detent_type | first_place |
| adgroup_add_command_v_o.campaign.adgroup_list | AdgroupCommandVO [] | 否 | 单元列表 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| adgroup_add_command_v_o.campaign.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| adgroup_add_command_v_o.campaign.adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | 物料名称 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].title | String | 否 | 展示标题 | 物料标题 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].link_url | String | 否 | 业务字段 link_url | https://h5.m.taobao.com/****timemove |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/******.jpg |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].live_id | Number | 否 | 业务对象标识 | 474297730705 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].live_title | String | 否 | 业务字段 live_title | 直播间隔一小时抽免单 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].material_id | Number | 否 | 素材标识 | 474847464897 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].status | Number | 否 | 状态标识 | 4 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].material_type | Number | 否 | 素材类型 | 3 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].audit_reason | String | 否 | 业务字段 audit_reason | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].material_tag_id | Number | 否 | 素材标识 | 40 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].quantity | Number | 否 | 业务字段 quantity | 20 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].bid_count | Number | 否 | 出价数量 | 20 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].item_id | Number | 否 | 商品编号 | 474847464777 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].outer_status | Number | 否 | 业务字段 outer_status | 10 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].live_cover_img | String | 否 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].audit_status | Number | 否 | 业务字段 audit_status | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].live_start_time | Date | 否 | 业务字段 live_start_time | 2024-08-02 07:44:22 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].video_ori_url | String | 否 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].pv | Number | 否 | 业务字段 pv | 35 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].trade_amt | Number | 否 | 业务字段 trade_amt | 147 |
| adgroup_add_command_v_o.campaign.adgroup_list[].spot_list[].live_start_time_str | String | 否 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| adgroup_add_command_v_o.campaign.adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| adgroup_add_command_v_o.campaign.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 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| adgroup_add_command_v_o.campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| adgroup_add_command_v_o.campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| adgroup_add_command_v_o.campaign.more_campaign_switch | Boolean | 否 | 业务字段 more_campaign_switch | false |
| adgroup_add_command_v_o.campaign.conv | Number | 否 | 业务字段 conv | 10 |
| adgroup_add_command_v_o.campaign.common_filters | String | 否 | 业务字段 common_filters | — |
| adgroup_add_command_v_o.campaign.smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| adgroup_add_command_v_o.campaign.crowd_extend_type | String | 否 | 业务字段 crowd_extend_type | auto |
| adgroup_add_command_v_o.campaign.whole_member_ship | Boolean | 否 | 业务字段 whole_member_ship | false |
| adgroup_add_command_v_o.campaign.crowd_custom_type | Boolean | 否 | 业务字段 crowd_custom_type | false |
| adgroup_add_command_v_o.campaign.creative_skin | String | 否 | 业务字段 creative_skin | xxxxx |
| adgroup_add_command_v_o.adgroup_list | AdgroupCommandVO [] | 是 | 单元列表 | — |
| adgroup_add_command_v_o.adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| adgroup_add_command_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| adgroup_add_command_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| adgroup_add_command_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| adgroup_add_command_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| adgroup_add_command_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| adgroup_add_command_v_o.adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| adgroup_add_command_v_o.adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| adgroup_add_command_v_o.adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| adgroup_add_command_v_o.adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| adgroup_add_command_v_o.adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| adgroup_add_command_v_o.adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| adgroup_add_command_v_o.adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| adgroup_add_command_v_o.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 1 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | 物料名称 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].title | String | 否 | 展示标题 | 物料标题 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].link_url | String | 否 | 业务字段 link_url | https://h5.m.taobao.com/****timemove |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/******.jpg |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].live_id | Number | 否 | 业务对象标识 | 474297730705 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].live_title | String | 否 | 业务字段 live_title | 直播间隔一小时抽免单 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].material_id | Number | 否 | 素材标识 | 474847464897 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].status | Number | 否 | 状态标识 | 4 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].material_type | Number | 否 | 素材类型 | 3 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].audit_reason | String | 否 | 业务字段 audit_reason | 1 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].material_tag_id | Number | 否 | 素材标识 | 40 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].quantity | Number | 否 | 业务字段 quantity | 20 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].bid_count | Number | 否 | 出价数量 | 20 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].item_id | Number | 否 | 商品编号 | 474847464777 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].outer_status | Number | 否 | 业务字段 outer_status | 10 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].live_cover_img | String | 否 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].audit_status | Number | 否 | 业务字段 audit_status | 1 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].live_start_time | Date | 否 | 业务字段 live_start_time | 2024-08-02 07:44:22 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].video_ori_url | String | 否 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].pv | Number | 否 | 业务字段 pv | 35 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].trade_amt | Number | 否 | 业务字段 trade_amt | 147 |
| adgroup_add_command_v_o.adgroup_list[].spot_list[].live_start_time_str | String | 否 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| adgroup_add_command_v_o.adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| adgroup_add_command_v_o.adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| adgroup_add_command_v_o.adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| adgroup_add_command_v_o.adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| adgroup_add_command_v_o.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 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| adgroup_add_command_v_o.adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |

## 响应业务字段

TOP 响应外层：`universalbp_new_adgroup_addlist_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adgroup_addlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adgroup_addlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adgroup_addlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adgroup_addlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adgroup_addlist_response.top_result.info.error_code |
| top_result.solution_add_result_v_o_top_part_data | TopPartData | 未标注 | 结果对象 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data |
| top_result.solution_add_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.count |
| top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list | SolutionAddResultVO [] | 未标注 | 结果列表集合 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list |
| top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list.solution_add_result_v_o[].campaign_id |
| top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list[].adgroup_result_list | AdgroupAddResultVO [] | 未标注 | 单元结果列表 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list.solution_add_result_v_o[].adgroup_result_list |
| top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list[].adgroup_result_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list.solution_add_result_v_o[].adgroup_result_list.adgroup_add_result_v_o[].adgroup_id |
| top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list[].adgroup_result_list[].material_id | Number | 未标注 | 素材标识 | 476133454293 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.solution_add_result_v_o_list.solution_add_result_v_o[].adgroup_result_list.adgroup_add_result_v_o[].material_id |
| top_result.solution_add_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_count |
| top_result.solution_add_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details |
| top_result.solution_add_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.solution_add_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details.top_fail_result[].msg |
| top_result.solution_add_result_v_o_top_part_data.error_details[].result | SolutionAddResultVO | 未标注 | 执行结果内容 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details.top_fail_result[].result |
| top_result.solution_add_result_v_o_top_part_data.error_details[].result.adgroup_result_list | AdgroupAddResultVO [] | 未标注 | 单元结果列表 | — | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details.top_fail_result[].result.adgroup_result_list |
| top_result.solution_add_result_v_o_top_part_data.error_details[].result.adgroup_result_list[].material_id | Number | 未标注 | 素材标识 | 4758821397 | universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details.top_fail_result[].result.adgroup_result_list.adgroup_add_result_v_o[].material_id |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.adgroup.addlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adgroup_add_command_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.adgroup.addlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"adgroup_add_command_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.solution_add_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_adgroup_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details）

来源校验 SHA256：b543041215aece351a495cddbb8b51e4246a7a80dfadd539a3dfcc47d3ec4b57

