# 奇门云万相台 API 对接参考

核对日期：2026-09-19，共 136 个接口。

此文档为业务字段和本站接入方式的整理版。官方长篇说明、场景限制及最新规则请查看每个接口的官方来源链接。

## 本站通用调用约定

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

---

# 实时报表查询

`taobao.universalbp.new.report.query.realtime`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_real_time_report_query_v_o | TopRealTimeReportQueryVO | 是 | 时间报表查询对象 | — |
| top_real_time_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_real_time_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_real_time_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_real_time_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| top_real_time_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-06 |
| top_real_time_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| top_real_time_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [campaign， date] |
| top_real_time_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_real_time_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_real_time_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合；全站推分时数据必传 | [68798644117] |
| top_real_time_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_real_time_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_real_time_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_real_time_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_real_time_report_query_v_o.source_list | String [] | 否 | 业务条件集合 | [SCENE] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_realtime_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_realtime_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_realtime_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_realtime_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_realtime_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_roi | String | 未标注 | 业务字段 retained_roi | 100 | universalbp_new_report_query_realtime_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_roi |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.realtime",
  "params": {
    "top_service_context": {
      "biz_code": "onebpSite",
      "login_type": 1,
      "ext": "{}"
    },
    "top_real_time_report_query_v_o": {
      "by_page": false,
      "split_type": "hour",
      "unify_type": "zhai",
      "effect_equal": 15,
      "start_time": "2026-11-18",
      "end_time": "2026-11-18",
      "query_domains": [
        "campaign",
        "date"
      ],
      "query_field_in_list": [
        "adPv",
        "click",
        "charge",
        "alipayInshopAmt",
        "alipayInshopNum"
      ],
      "biz_code_in_list": [
        "onebpSite"
      ],
      "offset": 0,
      "page_size": 100,
      "source": "baseReport",
      "strategy_campaign_id_in_list": [
        "替换为计划列表返回的campaign_id"
      ]
    }
  }
}

```

## 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.report.query.realtime\",\"params\":{\"top_service_context\":{\"biz_code\":\"onebpSite\",\"login_type\":1,\"ext\":\"{}\"},\"top_real_time_report_query_v_o\":{\"by_page\":false,\"split_type\":\"hour\",\"unify_type\":\"zhai\",\"effect_equal\":15,\"start_time\":\"2026-11-18\",\"end_time\":\"2026-11-18\",\"query_domains\":[\"campaign\",\"date\"],\"query_field_in_list\":[\"adPv\",\"click\",\"charge\",\"alipayInshopAmt\",\"alipayInshopNum\"],\"biz_code_in_list\":[\"onebpSite\"],\"offset\":0,\"page_size\":100,\"source\":\"baseReport\",\"strategy_campaign_id_in_list\":[\"替换为计划列表返回的campaign_id\"]}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：aef407741008573714a2c649ef3c6289a6bbcbe5059d4d50ca5ea2deb47cb010



---

# 查询计划分页列表

`taobao.universalbp.new.campaign.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_query_v_o | CampaignQueryVO | 是 | 计划查询条件 | — |
| campaign_query_v_o.status_list | String [] | 否 | 筛选状态集合 | [ "start", "pause" ] |
| campaign_query_v_o.need_target_crowd_list | String [] | 否 | 目标人群集合 | ["smartCrowd"] |
| campaign_query_v_o.origin_secondary_scene_list | String [] | 否 | 业务条件集合 | ["promotion_scene_item"] |
| campaign_query_v_o.promotion_type_list | String [] | 否 | 类型集合 | [ "item", "shop" ] |
| campaign_query_v_o.bid_type_list | String [] | 否 | 出价类型列表 | ["roi_control"] |
| campaign_query_v_o.campaign_name_like | String | 否 | 业务字段 campaign_name_like | 计划名称 |
| campaign_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| campaign_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68796878069] |
| campaign_query_v_o.item_id | Number | 否 | 商品编号 | 752793518760 |
| campaign_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| campaign_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| campaign_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| campaign_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| campaign_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| campaign_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| campaign_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| campaign_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| campaign_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| campaign_query_v_o.adgroup_required | Boolean | 否 | 业务字段 adgroup_required | false |
| campaign_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| campaign_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| campaign_query_v_o.promotion_scene_list | String [] | 否 | 业务条件集合 | ["promotion_scene_crowd"] |
| campaign_query_v_o.optimize_target_list | String [] | 否 | 优化目标列表 | ["click"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | — |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | — |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | — |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | — |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | — |
| top_result.campaign_v_o_top_bulk_data | TopBulkData | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_scene | String | 未标注 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].optimize_target | String | 未标注 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list[].age_list | String [] | 未标注 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].common_filter | String | 未标注 | 业务字段 common_filter | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list | AdgroupVO [] | 未标注 | 单元列表 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].gmt_create | Date | 未标注 | 业务字段 gmt_create | 2023-12-09 14:34:12 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].gmt_modified | Date | 未标注 | 业务字段 gmt_modified | 2023-12-09 14:34:12 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-1=待审核、0=后台下线状态、1=后台上线状态 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | xxxxx | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc | AdgroupOcpcVO | 未标注 | 单元对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 未标注 | 业务字段 enable_ocpc；枚举：false=否、true=是 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 未标注 | 业务字段 ocpc_marketing_aim | click | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.ocpc_status | String | 未标注 | 业务字段 ocpc_status；枚举：new_ad_openable=可开启新广告加速、new_item_openable=可开启新品冷启动、new_ad_speeding=新广告加速加速中、new_item_speeding=新品冷启动加速中、new_ad_complete=新广告加速加速完成、new_item_complete=新品冷启动加速完成 | new_ad_complete | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.enable_cold_speed_new_item | Boolean | 未标注 | 业务字段 enable_cold_speed_new_item；枚举：true=是、false=否 | false | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].adgroup_ocpc.ecpc_option | Number | 未标注 | 业务字段 ecpc_option | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material | CommonMaterialVO | 未标注 | 素材 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.material_id | Number | 未标注 | 素材标识 | 714616513841 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.material_type | Number | 未标注 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.price | String | 未标注 | 金额 | 999900 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.bid_count | Number | 未标注 | 出价数量 | 899900 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.quantity | Number | 未标注 | 业务字段 quantity | 10 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.category_id | String | 未标注 | 业务对象标识 | 16 50010850 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_list | ItemLifeCycleViewVO [] | 未标注 | 列表集合；列表中最多有2个元素 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_list[].life_cycle_desc | String | 未标注 | 业务字段 life_cycle_desc | 新品打爆期 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_list[].color | String | 未标注 | 业务字段 color | #36A2FC | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_list[].tips | String | 未标注 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_list[].type | Number | 未标注 | 类型 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_days | Number | 未标注 | 业务字段 life_cycle_days | 3 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_diff_with_avg | String | 未标注 | 业务字段 life_cycle_diff_with_avg | 较慢 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.life_cycle_diff_with_avg_tips | String | 未标注 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.grow_desc | String | 未标注 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].material.grow_rank | Number | 未标注 | 业务字段 grow_rank | 1077 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].alive_group_id | Number | 未标注 | 业务对象标识；枚举：0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].alive_group_name | String | 未标注 | 业务字段 alive_group_name | 宝贝链接(默认) | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].black_creative_status | String | 未标注 | 业务字段 black_creative_status；枚举：success=合成成功、fail=合成失败 | success | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].spot_list | SpotVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].spot_list[].spot_id | Number | 未标注 | 业务对象标识 | 3 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].spot_list[].material_name | String | 未标注 | 素材名称 | xxxxx | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].adgroup_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].scene_id | Number | 未标注 | 业务对象标识 | promotion_scene_item | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_type_v2 | String | 未标注 | 业务字段 bid_type_v2 | smart_bid | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_target_v2 | String | 未标注 | 业务字段 bid_target_v2 | conv | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].set_single_cost_v2 | Boolean | 未标注 | 业务字段 set_single_cost_v2 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].shield_words | String [] | 未标注 | 业务字段 shield_words | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_budget_list | CampaignPeriodBudgetVO [] | 未标注 | 预算列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_budget_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_budget_list[].time_span_list | TimeSpanVO [] | 未标注 | 时间列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_budget_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_budget_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command | CampaignQuickLiftCommandVO | 未标注 | 预算操作对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_budget | String | 未标注 | 业务字段 quick_lift_budget | 50 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_time_slot | String | 未标注 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_launch_area_list | String [] | 未标注 | 地域集合 | all | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target | CampaignMultiTargetVO | 未标注 | 目标对象 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_switch | Number | 未标注 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 未标注 | 目标列表集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list[].optimize_target | String | 未标注 | 优化目标 | 1034 | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list[].multi_target_budget | String | 未标注 | 业务字段 multi_target_budget | 1000 | — |

## 核对备注

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

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "onebpSite",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_query_v_o": {
      "offset": 0,
      "page_size": 20,
      "adgroup_required": true
    }
  }
}

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：040fa68c4644f8c87ad278daff309592e164b8817f2e9d6b4e12ed4c88153a54



---

# 高级设置更改计划

`taobao.universalbp.new.campaign.advanced.batchupdate`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_advanced_list_v_o | CampaignAdvancedListVO | 是 | 计划列表对象 | — |
| campaign_advanced_list_v_o.campaign_list | CampaignAdvancedCommandVO [] | 是 | 计划列表 | — |
| campaign_advanced_list_v_o.campaign_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_advanced_list_v_o.campaign_list[].launch_area_str_list | String [] | 否 | 地域集合 | ["1","19"] 或者 ["all"] |
| campaign_advanced_list_v_o.campaign_list[].launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| campaign_advanced_list_v_o.campaign_list[].launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| campaign_advanced_list_v_o.campaign_list[].launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| campaign_advanced_list_v_o.campaign_list[].launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| campaign_advanced_list_v_o.campaign_list[].launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| campaign_advanced_list_v_o.campaign_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_advanced_list_v_o.campaign_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_advanced_list_v_o.campaign_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_advanced_list_v_o.campaign_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_advanced_list_v_o.campaign_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_advanced_list_v_o.campaign_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 否 | 人群列表集合 | — |
| campaign_advanced_list_v_o.campaign_list[].crowd_filter_list[].behavior | String | 否 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
| campaign_advanced_list_v_o.campaign_list[].crowd_filter_list[].window | String | 否 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
| campaign_advanced_list_v_o.campaign_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 否 | 列表集合 | — |
| campaign_advanced_list_v_o.campaign_list[].gender_age_filter_list[].gender | String | 否 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man |
| campaign_advanced_list_v_o.campaign_list[].gender_age_filter_list[].age_list | String [] | 否 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] |
| campaign_advanced_list_v_o.campaign_list[].shield_words | String [] | 否 | 业务字段 shield_words | ["屏蔽词"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_advanced_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_advanced_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_advanced_batchupdate_response.top_result.info.error_code |
| top_result.campaign_v_o_top_part_data | TopPartData | 未标注 | 计划对象 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data |
| top_result.campaign_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.count |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_biz_code |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_group_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_group_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_scene | String | 未标注 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_scene |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].market_scene | String | 未标注 | 业务字段 market_scene | wxt_live_max_view :最大化拿量 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].market_scene |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_goals |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_model |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_type_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].spot_continue |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].optimize_target | String | 未标注 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].optimize_target |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].online_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].display_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].top_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].top_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].dmc_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].day_budget |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].smooth_option |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].total_budget |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].budget_period |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].period_smooth |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].bid_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.enable_ocpc |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.ocpc_ratio |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].max_price |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].min_price |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].bid_unit |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].constraint_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].constraint_value |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot_stage |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].speed_type | String | 未标注 | 业务字段 speed_type | xxxxx | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].speed_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_discount |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_display_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_type | String | 未标注 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | xxxxx | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.start_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.end_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.launch_forever |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.renewal_first_order_start_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.renewal_first_order_end_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_area_str_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].day_of_week |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].discount |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].behavior |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].window |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].brand_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].deeplink_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].gender |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].age_list | String [] | 未标注 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].age_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.mini_detail_theme |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_item_id_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_top_item_id_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].item_selected_mode |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].shop_item_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].shield_items |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].scope_items |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].need_target_crowd |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].more_campaign_switch |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_custom_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_extend_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].origin_secondary_scene |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scene_id | Number | 未标注 | 业务对象标识 | 371 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].scene_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].is_xinxiang |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].is_guarantee |
| top_result.campaign_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.error_count |
| top_result.campaign_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.error_details |
| top_result.campaign_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.campaign_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.campaign_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_advanced_batchupdate_response.top_result.campaign_v_o_top_part_data.error_details）

来源校验 SHA256：5ffa29860c81c049674ce32d69e641bbdc552d24eeb25645cbb2044a224e7919



---

# 更新计划基础属性

`taobao.universalbp.new.campaign.updatepart`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_update_part_list_v_o | CampaignUpdatePartListVO | 是 | 计划列表对象 | — |
| campaign_update_part_list_v_o.campaign_list | CampaignUpdatePartCommandVO [] | 是 | 计划列表 | — |
| campaign_update_part_list_v_o.campaign_list[].campaign_id | Number | 是 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_update_part_list_v_o.campaign_list[].display_status | String | 否 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause |
| campaign_update_part_list_v_o.campaign_list[].campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| campaign_update_part_list_v_o.campaign_list[].launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| campaign_update_part_list_v_o.campaign_list[].top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| campaign_update_part_list_v_o.campaign_list[].launch_period_type | String | 否 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | true |
| campaign_update_part_list_v_o.campaign_list[].day_budget | Number | 否 | 日预算 | 499 |
| campaign_update_part_list_v_o.campaign_list[].total_budget | Number | 否 | 累计预算 | 350 |
| campaign_update_part_list_v_o.campaign_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_update_part_list_v_o.campaign_list[].constraint_type | String | 否 | 业务字段 constraint_type | roi |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| campaign_update_part_list_v_o.campaign_list[].launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| campaign_update_part_list_v_o.campaign_list[].launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| campaign_update_part_list_v_o.campaign_list[].dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| campaign_update_part_list_v_o.campaign_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | live_view_count |
| campaign_update_part_list_v_o.campaign_list[].promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| campaign_update_part_list_v_o.campaign_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| campaign_update_part_list_v_o.campaign_list[].budget_period | Number | 否 | 业务字段 budget_period | 7 |
| campaign_update_part_list_v_o.campaign_list[].auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| campaign_update_part_list_v_o.campaign_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_update_part_list_v_o.campaign_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_update_part_list_v_o.campaign_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| campaign_update_part_list_v_o.campaign_list[].smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | quick |
| campaign_update_part_list_v_o.campaign_list[].period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | quick |
| campaign_update_part_list_v_o.campaign_list[].search_detent_type | String | 否 | 业务字段 search_detent_type | first_place |
| campaign_update_part_list_v_o.campaign_list[].algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| campaign_update_part_list_v_o.campaign_list[].multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| campaign_update_part_list_v_o.campaign_list[].quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | — |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | — |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | — |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | — |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | — |
| top_result.campaign_v_o_top_part_data | TopPartData | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_scene | String | 未标注 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].market_scene | String | 未标注 | 业务字段 market_scene | wxt_live_max_view :最大化拿量 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].optimize_target | String | 未标注 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].speed_type | String | 未标注 | 业务字段 speed_type | xxxxx | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_type | String | 未标注 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].age_list | String [] | 未标注 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].common_filter | String | 未标注 | 业务字段 common_filter | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].common_filters | String | 未标注 | 业务字段 common_filters | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scene_id | Number | 未标注 | 业务对象标识 | promotion_scene_item | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | — |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | — |
| top_result.campaign_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | — |
| top_result.campaign_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | — |
| top_result.campaign_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | — |
| top_result.campaign_v_o_top_part_data.error_details[].result | CampaignVO | 未标注 | 执行结果内容 | — | — |
| top_result.campaign_v_o_top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | — |
| top_result.campaign_v_o_top_part_data.error_details[].result.campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | — |

## 核对备注

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

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

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

来源校验 SHA256：eff1a168a83aaf2ac3b5c97a4b657bf0044f14021e54b9c714b31ee120813d1f



---

# 更新计划所属计划组

`taobao.universalbp.new.campaign.updategroup`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_update_group_command_v_o | CampaignUpdateGroupCommandVO | 是 | 计划操作对象 | — |
| campaign_update_group_command_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68792788657] |
| campaign_update_group_command_v_o.campaign_group_id | Number | 是 | 计划标识 | 25481004 |
| campaign_update_group_command_v_o.new_campaign_group_name | String | 否 | 业务字段 new_campaign_group_name | 新建测试 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_updategroup_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_updategroup_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_updategroup_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_updategroup_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_updategroup_response.top_result.info.error_code |
| top_result.campaign_v_o_top_part_data | TopPartData | 未标注 | 计划对象 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data |
| top_result.campaign_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.count |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_biz_code |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_group_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_group_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_scene | String | 未标注 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_scene |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_goals |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_model |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].promotion_type_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].optimize_target | String | 未标注 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].optimize_target |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].online_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].display_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].top_status |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].top_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].dmc_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].day_budget |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].smooth_option |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].total_budget |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].budget_period |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].period_smooth |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].bid_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.enable_ocpc |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.ocpc_ratio |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].max_price |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].min_price |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].bid_unit |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].constraint_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].constraint_value |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].cold_boot_stage |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_discount |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_display_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.start_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.end_time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_time.launch_forever |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_area_str_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].day_of_week |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].time |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].discount |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].behavior |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].window |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].brand_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].deeplink_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_id |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_name |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].gender |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].gender_age_filter_list[].age_list | String [] | 未标注 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].age_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.mini_detail_theme |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_item_id_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_top_item_id_list |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].item_selected_mode |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].shop_item_type |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].shield_items |
| top_result.campaign_v_o_top_part_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.campaign_v_o_list.campaign_v_o[].scope_items |
| top_result.campaign_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.error_count |
| top_result.campaign_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.error_details |
| top_result.campaign_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.campaign_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_updategroup_response.top_result.campaign_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

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

来源校验 SHA256：d55cdcbd6398274a0a31b0c7e4483f0c9839463367add0a804d35bf02b00803b



---

# 查询单个计划详情

`taobao.universalbp.new.campaign.get`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_query_v_o | CampaignQueryVO | 是 | 计划查询条件 | — |
| campaign_query_v_o.status_list | String [] | 否 | 筛选状态集合 | [ "start", "pause" ] |
| campaign_query_v_o.promotion_scene_list | String [] | 否 | 业务条件集合 | ["promotion_scene_crowd"] |
| campaign_query_v_o.need_target_crowd_list | String [] | 否 | 目标人群集合 | ["smartCrowd"] |
| campaign_query_v_o.origin_secondary_scene_list | String [] | 否 | 业务条件集合 | ["promotion_scene_item"] |
| campaign_query_v_o.promotion_type_list | String [] | 否 | 类型集合 | [ "item", "shop" ] |
| campaign_query_v_o.bid_type_list | String [] | 否 | 出价类型列表 | ["roi_control"] |
| campaign_query_v_o.optimize_target_list | String [] | 否 | 优化目标列表 | ["click"] |
| campaign_query_v_o.campaign_name_like | String | 否 | 业务字段 campaign_name_like | 计划名称 |
| campaign_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| campaign_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68796878069] |
| campaign_query_v_o.item_id | Number | 否 | 商品编号 | 752793518760 |
| campaign_query_v_o.adgroup_required | Boolean | 否 | 业务字段 adgroup_required | false |
| campaign_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| campaign_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_get_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_get_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_get_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_get_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_get_response.top_result.info.error_code |
| top_result.top_campaign_v_o | TopCampaignVO | 未标注 | 计划 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o |
| top_result.top_campaign_v_o.campaign | CampaignVO | 未标注 | 计划 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign |
| top_result.top_campaign_v_o.campaign.campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_biz_code |
| top_result.top_campaign_v_o.campaign.campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_group_id |
| top_result.top_campaign_v_o.campaign.campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_group_name |
| top_result.top_campaign_v_o.campaign.campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_id |
| top_result.top_campaign_v_o.campaign.campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_name |
| top_result.top_campaign_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 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_scene |
| top_result.top_campaign_v_o.campaign.market_scene | String | 未标注 | 业务字段 market_scene | wxt_live_max_view :最大化拿量 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.market_scene |
| top_result.top_campaign_v_o.campaign.promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_goals |
| top_result.top_campaign_v_o.campaign.promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_model |
| top_result.top_campaign_v_o.campaign.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_type |
| top_result.top_campaign_v_o.campaign.promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_type_list |
| top_result.top_campaign_v_o.campaign.spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.spot_continue |
| top_result.top_campaign_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 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.sub_promotion_type |
| top_result.top_campaign_v_o.campaign.sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.sub_promotion_type_list |
| top_result.top_campaign_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 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.optimize_target |
| top_result.top_campaign_v_o.campaign.online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.online_status |
| top_result.top_campaign_v_o.campaign.display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.display_status |
| top_result.top_campaign_v_o.campaign.top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.top_status |
| top_result.top_campaign_v_o.campaign.top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.top_time |
| top_result.top_campaign_v_o.campaign.dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.dmc_type |
| top_result.top_campaign_v_o.campaign.day_budget | String | 未标注 | 日预算 | 100 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.day_budget |
| top_result.top_campaign_v_o.campaign.smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.smooth_option |
| top_result.top_campaign_v_o.campaign.total_budget | String | 未标注 | 累计预算 | 100 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.total_budget |
| top_result.top_campaign_v_o.campaign.budget_period | Number | 未标注 | 业务字段 budget_period | 7 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.budget_period |
| top_result.top_campaign_v_o.campaign.period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.period_smooth |
| top_result.top_campaign_v_o.campaign.bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_type |
| top_result.top_campaign_v_o.campaign.campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpc |
| top_result.top_campaign_v_o.campaign.campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpc.enable_ocpc |
| top_result.top_campaign_v_o.campaign.campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpc.ocpc_ratio |
| top_result.top_campaign_v_o.campaign.max_price | String | 未标注 | 最大金额 | 0.4 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.max_price |
| top_result.top_campaign_v_o.campaign.min_price | String | 未标注 | 最小金额 | 0.25 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.min_price |
| top_result.top_campaign_v_o.campaign.bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_unit |
| top_result.top_campaign_v_o.campaign.constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.constraint_type |
| top_result.top_campaign_v_o.campaign.constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.constraint_value |
| top_result.top_campaign_v_o.campaign.cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_boot |
| top_result.top_campaign_v_o.campaign.cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_boot_time |
| top_result.top_campaign_v_o.campaign.cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_boot_stage |
| top_result.top_campaign_v_o.campaign.speed_type | String | 未标注 | 业务字段 speed_type | xxxxx | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.speed_type |
| top_result.top_campaign_v_o.campaign.launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_discount |
| top_result.top_campaign_v_o.campaign.launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_display_time |
| top_result.top_campaign_v_o.campaign.launch_period_type | String | 未标注 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | xxxxx | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_type |
| top_result.top_campaign_v_o.campaign.launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time |
| top_result.top_campaign_v_o.campaign.launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.start_time |
| top_result.top_campaign_v_o.campaign.launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.end_time |
| top_result.top_campaign_v_o.campaign.launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.launch_forever |
| top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_start_time |
| top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_end_time |
| top_result.top_campaign_v_o.campaign.launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_area_str_list |
| top_result.top_campaign_v_o.campaign.launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list |
| top_result.top_campaign_v_o.campaign.launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].day_of_week |
| top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].time_span_list |
| top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].time |
| top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].discount |
| top_result.top_campaign_v_o.campaign.crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_list |
| top_result.top_campaign_v_o.campaign.crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_list.campaign_crowd_filter_v_o[].behavior |
| top_result.top_campaign_v_o.campaign.crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_list.campaign_crowd_filter_v_o[].window |
| top_result.top_campaign_v_o.campaign.brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_list |
| top_result.top_campaign_v_o.campaign.brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_list.campaign_brand_filter_v_o[].brand_id |
| top_result.top_campaign_v_o.campaign.brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_list.campaign_brand_filter_v_o[].deeplink_list |
| top_result.top_campaign_v_o.campaign.deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_list |
| top_result.top_campaign_v_o.campaign.deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_id |
| top_result.top_campaign_v_o.campaign.deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_name |
| top_result.top_campaign_v_o.campaign.gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_list |
| top_result.top_campaign_v_o.campaign.gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_list.campaign_gender_age_filter_v_o[].gender |
| top_result.top_campaign_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] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_list.campaign_gender_age_filter_v_o[].age_list |
| top_result.top_campaign_v_o.campaign.mini_detail | CampaignMiniDetailCommandVO | 未标注 | 业务对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail |
| top_result.top_campaign_v_o.campaign.mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.mini_detail_theme |
| top_result.top_campaign_v_o.campaign.mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_item_id_list |
| top_result.top_campaign_v_o.campaign.mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_top_item_id_list |
| top_result.top_campaign_v_o.campaign.mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_type |
| top_result.top_campaign_v_o.campaign.item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.item_selected_mode |
| top_result.top_campaign_v_o.campaign.shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.shop_item_type |
| top_result.top_campaign_v_o.campaign.shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.shield_items |
| top_result.top_campaign_v_o.campaign.scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.scope_items |
| top_result.top_campaign_v_o.campaign.adgroup_list | AdgroupVO [] | 未标注 | 单元列表 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list |
| top_result.top_campaign_v_o.campaign.adgroup_list[].gmt_create | Date | 未标注 | 业务字段 gmt_create | 2023-12-09 14:34:12 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].gmt_create |
| top_result.top_campaign_v_o.campaign.adgroup_list[].gmt_modified | Date | 未标注 | 业务字段 gmt_modified | 2023-12-09 14:34:12 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].gmt_modified |
| top_result.top_campaign_v_o.campaign.adgroup_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].campaign_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].campaign_name |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_name |
| top_result.top_campaign_v_o.campaign.adgroup_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].online_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].display_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-1=待审核、0=后台下线状态、1=后台上线状态 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].audit_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | xxxxx | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].audit_reason |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc | AdgroupOcpcVO | 未标注 | 单元对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 未标注 | 业务字段 enable_ocpc；枚举：false=否、true=是 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.enable_ocpc |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_ratio |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 未标注 | 业务字段 ocpc_marketing_aim | click | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_marketing_aim |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_status | String | 未标注 | 业务字段 ocpc_status；枚举：new_ad_openable=可开启新广告加速、new_item_openable=可开启新品冷启动、new_ad_speeding=新广告加速中、new_item_speeding=新品冷启动加速中、new_ad_complete=新广告加速完成、new_item_complete=新品冷启动加速完成 | new_ad_complete | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.enable_cold_speed_new_item | Boolean | 未标注 | 业务字段 enable_cold_speed_new_item；枚举：true=是、false=否 | false | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.enable_cold_speed_new_item |
| top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ecpc_option | Number | 未标注 | 业务字段 ecpc_option | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ecpc_option |
| top_result.top_campaign_v_o.campaign.adgroup_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].promotion_type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].sub_promotion_type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material | CommonMaterialVO | 未标注 | 素材 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.material_type | Number | 未标注 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_name |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.title |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.img_url |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.link_url |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.price | String | 未标注 | 金额 | 999900 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.price |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.bid_count | Number | 未标注 | 出价数量 | 899900 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.bid_count |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.quantity | Number | 未标注 | 业务字段 quantity | 10 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.quantity |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.first_starts_time |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.starts |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.category_id | String | 未标注 | 业务对象标识 | 16 50010850 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.category_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.promotion_type |
| top_result.top_campaign_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 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.sub_promotion_type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list | ItemLifeCycleViewVO [] | 未标注 | 列表集合；列表中最多有2个元素 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_list |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].life_cycle_desc | String | 未标注 | 业务字段 life_cycle_desc | 新品打爆期 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].life_cycle_desc |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].color | String | 未标注 | 业务字段 color | #36A2FC | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].color |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].tips | String | 未标注 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].tips |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].type | Number | 未标注 | 类型 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_days | Number | 未标注 | 业务字段 life_cycle_days | 3 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_days |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_diff_with_avg | String | 未标注 | 业务字段 life_cycle_diff_with_avg | 较慢 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_diff_with_avg |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_diff_with_avg_tips | String | 未标注 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_diff_with_avg_tips |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.grow_desc | String | 未标注 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.grow_desc |
| top_result.top_campaign_v_o.campaign.adgroup_list[].material.grow_rank | Number | 未标注 | 业务字段 grow_rank | 1077 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.grow_rank |
| top_result.top_campaign_v_o.campaign.adgroup_list[].alive_group_id | Number | 未标注 | 业务对象标识；枚举：0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].alive_group_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].alive_group_name | String | 未标注 | 业务字段 alive_group_name | 宝贝链接(默认) | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].alive_group_name |
| top_result.top_campaign_v_o.campaign.adgroup_list[].black_creative_status | String | 未标注 | 业务字段 black_creative_status；枚举：success=合成成功、fail=合成失败 | success | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].black_creative_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list | SpotVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].spot_id | Number | 未标注 | 业务对象标识 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].spot_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_name | String | 未标注 | 素材名称 | 物料名称 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_name |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].title | String | 未标注 | 展示标题 | 物料标题 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].title |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].link_url | String | 未标注 | 业务字段 link_url | https://h5.m.taobao.com/****timemove | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].link_url |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/******.jpg | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].img_url |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_id | Number | 未标注 | 业务对象标识 | 474297730705 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_title | String | 未标注 | 业务字段 live_title | 直播间隔一小时抽免单 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_title |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_id | Number | 未标注 | 素材标识 | 474847464897 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].status | Number | 未标注 | 状态标识 | 4 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_type | Number | 未标注 | 素材类型 | 3 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_type |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].audit_reason |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_tag_id | Number | 未标注 | 素材标识 | 40 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_tag_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].quantity | Number | 未标注 | 业务字段 quantity | 20 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].quantity |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].bid_count | Number | 未标注 | 出价数量 | 20 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].bid_count |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].item_id | Number | 未标注 | 商品编号 | 474847464777 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].item_id |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].outer_status | Number | 未标注 | 业务字段 outer_status | 10 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].outer_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_cover_img | String | 未标注 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_cover_img |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].audit_status | Number | 未标注 | 业务字段 audit_status | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].audit_status |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_start_time | Date | 未标注 | 业务字段 live_start_time | 2024-08-02 07:44:22 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_start_time |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].video_ori_url | String | 未标注 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].video_ori_url |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].pv | Number | 未标注 | 业务字段 pv | 35 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].pv |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].trade_amt | Number | 未标注 | 业务字段 trade_amt | 147 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].trade_amt |
| top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_start_time_str | String | 未标注 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_start_time_str |
| top_result.top_campaign_v_o.campaign.need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.need_target_crowd |
| top_result.top_campaign_v_o.campaign.more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.more_campaign_switch |
| top_result.top_campaign_v_o.campaign.crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_custom_type |
| top_result.top_campaign_v_o.campaign.crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_extend_type |
| top_result.top_campaign_v_o.campaign.origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.origin_secondary_scene |
| top_result.top_campaign_v_o.campaign.scene_id | Number | 未标注 | 业务对象标识 | 371 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.scene_id |
| top_result.top_campaign_v_o.campaign.is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.is_xinxiang |
| top_result.top_campaign_v_o.campaign.is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.is_guarantee |
| top_result.top_campaign_v_o.campaign.bid_type_v2 | String | 未标注 | 业务字段 bid_type_v2 | smart_bid | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_type_v2 |
| top_result.top_campaign_v_o.campaign.bid_target_v2 | String | 未标注 | 业务字段 bid_target_v2 | conv | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_target_v2 |
| top_result.top_campaign_v_o.campaign.set_single_cost_v2 | Boolean | 未标注 | 业务字段 set_single_cost_v2 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.set_single_cost_v2 |
| top_result.top_campaign_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 未标注 | 预算操作对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command |
| top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_switch |
| top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String | 未标注 | 业务字段 quick_lift_budget | 50 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_budget |
| top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String | 未标注 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot |
| top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 未标注 | 地域集合 | — | — |
| top_result.top_campaign_v_o.campaign.quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_switch |
| top_result.top_campaign_v_o.campaign.multi_target | CampaignMultiTargetVO | 未标注 | 目标对象 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target |
| top_result.top_campaign_v_o.campaign.multi_target.multi_target_switch | Number | 未标注 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_switch |
| top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 未标注 | 目标列表集合 | — | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list |
| top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String | 未标注 | 优化目标 | 1034 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list.campaign_multi_target_config_v_o[].optimize_target |
| top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 未标注 | 业务字段 multi_target_budget | 1000 | universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list.campaign_multi_target_config_v_o[].multi_target_budget |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：0327b9d6265351af60d72fbd36e6c99156a0bdc9e58612d1156124f1629d9d55



---

# 查询全量计划列表(不分页)

`taobao.universalbp.new.campaign.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_query_v_o | CampaignQueryVO | 是 | 计划查询条件 | — |
| campaign_query_v_o.status_list | String [] | 否 | 筛选状态集合 | [ "start", "pause" ] |
| campaign_query_v_o.need_target_crowd_list | String [] | 否 | 目标人群集合 | ["smartCrowd"] |
| campaign_query_v_o.origin_secondary_scene_list | String [] | 否 | 业务条件集合 | ["promotion_scene_item"] |
| campaign_query_v_o.promotion_type_list | String [] | 否 | 类型集合 | [ "item", "shop" ] |
| campaign_query_v_o.bid_type_list | String [] | 否 | 出价类型列表 | ["roi_control"] |
| campaign_query_v_o.campaign_name_like | String | 否 | 业务字段 campaign_name_like | 计划名称 |
| campaign_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| campaign_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68796878069] |
| campaign_query_v_o.item_id | Number | 否 | 商品编号 | 752793518760 |
| campaign_query_v_o.offset | Number | 否 | 结果起始偏移 | 0 |
| campaign_query_v_o.page_size | Number | 否 | 单页条数 | 20 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_findlist_response.top_result.info.error_code |
| top_result.campaign_v_o_top_bulk_data | TopBulkData | 未标注 | 计划对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data |
| top_result.campaign_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.count |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list | CampaignVO [] | 未标注 | 计划列表 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_biz_code | String | 未标注 | 业务字段 campaign_biz_code | onebpDisplay | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_biz_code |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25696724 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_group_id |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 测试 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_group_name |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_id |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_name |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_scene | String | 未标注 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].promotion_scene |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].market_scene | String | 未标注 | 业务字段 market_scene | wxt_live_max_view :最大化拿量 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].market_scene |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_goals | String | 未标注 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].promotion_goals |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_model | String | 未标注 | 业务字段 promotion_model | daily:持续推广,order:套餐包 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].promotion_model |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].promotion_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].promotion_type_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].spot_continue | Number | 未标注 | 业务字段 spot_continue | 10 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].spot_continue |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].sub_promotion_type_list | String [] | 未标注 | 类型集合 | ["item"] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].sub_promotion_type_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].optimize_target | String | 未标注 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].optimize_target |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].online_status |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].display_status |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].top_status | Boolean | 未标注 | 是否置顶；枚举：true=置顶、false=不置顶 | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].top_status |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].top_time | Date | 未标注 | 时间 | 2023-06-12 12:00:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].top_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].dmc_type | String | 未标注 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].dmc_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].day_budget | String | 未标注 | 日预算 | 100 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].day_budget |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].smooth_option | String | 未标注 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].smooth_option |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].total_budget | String | 未标注 | 累计预算 | 100 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].total_budget |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].budget_period | Number | 未标注 | 业务字段 budget_period | 7 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].budget_period |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].period_smooth | String | 未标注 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].period_smooth |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].bid_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc | CampaignOcpcVO | 未标注 | 计划对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc.enable_ocpc | String | 未标注 | 业务字段 enable_ocpc；枚举：0=否、1=是 | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.enable_ocpc |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].campaign_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].campaign_ocpc.ocpc_ratio |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].max_price | String | 未标注 | 最大金额 | 0.4 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].max_price |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].min_price | String | 未标注 | 最小金额 | 0.25 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].min_price |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_unit | String | 未标注 | 业务字段 bid_unit | 元/次点击 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].bid_unit |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].constraint_type | String | 未标注 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].constraint_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].constraint_value | String | 未标注 | 业务字段 constraint_value | 3 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].constraint_value |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot | Number | 未标注 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].cold_boot |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot_time | Date | 未标注 | 业务字段 cold_boot_time | 2023-06-11 23:56:23 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].cold_boot_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].cold_boot_stage | String | 未标注 | 业务字段 cold_boot_stage；枚举：cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中 | mature | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].cold_boot_stage |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].speed_type | String | 未标注 | 业务字段 speed_type | xxxxx | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].speed_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_discount | String | 未标注 | 业务字段 launch_period_discount | 100% | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_discount |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_display_time | String | 未标注 | 业务字段 launch_period_display_time | 15:00-15:30 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_display_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_type | String | 未标注 | 业务字段 launch_period_type；枚举：allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段 | xxxxx | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time | CampaignLaunchTimeVO | 未标注 | 时间对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.start_time | Date | 未标注 | 查询或投放起始时间 | 2023-06-09 00:00:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time.start_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.end_time | Date | 未标注 | 查询或投放结束时间 | 2199-02-01 00:00:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time.end_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.launch_forever | Boolean | 未标注 | 业务字段 launch_forever；枚举：true=是、false=否 | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time.launch_forever |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.renewal_first_order_start_time | Date | 未标注 | 业务字段 renewal_first_order_start_time | 2023-06-09 00:00:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time.renewal_first_order_start_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_time.renewal_first_order_end_time | Date | 未标注 | 业务字段 renewal_first_order_end_time | 2199-02-01 00:00:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_time.renewal_first_order_end_time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_area_str_list | String [] | 未标注 | 地域集合 | ["1","19"] 或者 ["all"] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_area_str_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list | LaunchPeriodVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].day_of_week | Number | 未标注 | 业务字段 day_of_week | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].day_of_week |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list | TimeSpanQueryResVO [] | 未标注 | 时间列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list[].time | String | 未标注 | 时间 | 00:00-24:00 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].time |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].launch_period_list[].time_span_list[].discount | Number | 未标注 | 出价溢价 | 100 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].launch_period_list.launch_period_v_o[].time_span_list.time_span_query_res_v_o[].discount |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list | CampaignCrowdFilterVO [] | 未标注 | 人群列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list[].behavior | String | 未标注 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].behavior |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_filter_list[].window | String | 未标注 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].crowd_filter_list.campaign_crowd_filter_v_o[].window |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list | CampaignBrandFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].brand_filter_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list[].brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].brand_id |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].brand_filter_list[].deeplink_list | String [] | 未标注 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].brand_filter_list.campaign_brand_filter_v_o[].deeplink_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list | DeeplinkBrandVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_id | String | 未标注 | 业务对象标识 | 20067 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_id |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].deeplink_brand_list[].deeplink_brand_name | String | 未标注 | 业务字段 deeplink_brand_name | Lancome/兰蔻 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_name |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list | CampaignGenderAgeFilterVO [] | 未标注 | 列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list[].gender | String | 未标注 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].gender |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].gender_age_filter_list[].age_list | String [] | 未标注 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].gender_age_filter_list.campaign_gender_age_filter_v_o[].age_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail | CampaignMiniDetailVO | 未标注 | 业务对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].mini_detail |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.mini_detail_theme | String | 未标注 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].mini_detail.mini_detail_theme |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203, 714901906337] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_item_id_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_top_item_id_list | Number [] | 未标注 | 商品标识集合 | [714707465203] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_top_item_id_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].mini_detail.private_mini_type | Number | 未标注 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].mini_detail.private_mini_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].item_selected_mode | String | 未标注 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].item_selected_mode |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].shop_item_type | String | 未标注 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].shop_item_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].shield_items | Number [] | 未标注 | 业务字段 shield_items | [714707465203, 714901906337] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].shield_items |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].scope_items | Number [] | 未标注 | 业务字段 scope_items | [714707465203, 714901906337] | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].scope_items |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].need_target_crowd | Number | 未标注 | 业务字段 need_target_crowd | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].need_target_crowd |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].more_campaign_switch | Boolean | 未标注 | 业务字段 more_campaign_switch | false | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].more_campaign_switch |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_custom_type | Boolean | 未标注 | 业务字段 crowd_custom_type | false | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].crowd_custom_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].crowd_extend_type |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].origin_secondary_scene | String | 未标注 | 业务字段 origin_secondary_scene | promotion_scene_item | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].origin_secondary_scene |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].scene_id | Number | 未标注 | 业务对象标识 | 371 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].scene_id |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].is_xinxiang | Boolean | 未标注 | 业务字段 is_xinxiang | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].is_xinxiang |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].is_guarantee | Boolean | 未标注 | 业务字段 is_guarantee | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].is_guarantee |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_type_v2 | String | 未标注 | 业务字段 bid_type_v2 | smart_bid | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].bid_type_v2 |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].bid_target_v2 | String | 未标注 | 业务字段 bid_target_v2 | conv | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].bid_target_v2 |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].set_single_cost_v2 | Boolean | 未标注 | 业务字段 set_single_cost_v2 | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].set_single_cost_v2 |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command | CampaignQuickLiftCommandVO | 未标注 | 预算操作对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].quick_lift_budget_command |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].quick_lift_budget_command.quick_lift_switch |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_budget | String | 未标注 | 业务字段 quick_lift_budget | 50 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].quick_lift_budget_command.quick_lift_budget |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_time_slot | String | 未标注 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].quick_lift_budget_command.quick_lift_time_slot |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_budget_command.quick_lift_launch_area_list | String [] | 未标注 | 地域集合 | — | — |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].quick_lift_switch | Boolean | 未标注 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].quick_lift_switch |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target | CampaignMultiTargetVO | 未标注 | 目标对象 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].multi_target |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_switch | Number | 未标注 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].multi_target.multi_target_switch |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 未标注 | 目标列表集合 | — | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].multi_target.multi_target_config_list |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list[].optimize_target | String | 未标注 | 优化目标 | 1034 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].multi_target.multi_target_config_list.campaign_multi_target_config_v_o[].optimize_target |
| top_result.campaign_v_o_top_bulk_data.campaign_v_o_list[].multi_target.multi_target_config_list[].multi_target_budget | String | 未标注 | 业务字段 multi_target_budget | 1000 | universalbp_new_campaign_findlist_response.top_result.campaign_v_o_top_bulk_data.campaign_v_o_list.campaign_v_o[].multi_target.multi_target_config_list.campaign_multi_target_config_v_o[].multi_target_budget |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：5d07a8fe3b5c0172af0cd0c98093883fcc64806e044e276c2405ab04cdc4b9f4



---

# 删除计划

`taobao.universalbp.new.campaign.delete`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_delete_list_v_o | CampaignDeleteListVO | 是 | 计划删除对象 | — |
| campaign_delete_list_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | 5,3 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_delete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_delete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_delete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_delete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_delete_response.top_result.info.error_code |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：ae9fdc610a1efeab551829ed8e1a6d24e74381b53f49d906fc850622da2bd666



---

# 计划批量创建接口

`taobao.universalbp.new.solution.addlist`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| solution_command_list_v_o | SolutionCommandListVO | 是 | 操作列表对象 | — |
| solution_command_list_v_o.solution_list | SolutionCommandVO [] | 是 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].biz_code | String | 是 | 推广场景标识 | onebpDisplay |
| solution_command_list_v_o.solution_list[].campaign | CampaignCommandVO | 是 | 计划 | — |
| solution_command_list_v_o.solution_list[].campaign.campaign_biz_code | String | 否 | 业务字段 campaign_biz_code | onebpDisplay |
| solution_command_list_v_o.solution_list[].campaign.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| solution_command_list_v_o.solution_list[].campaign.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| solution_command_list_v_o.solution_list[].campaign.campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| solution_command_list_v_o.solution_list[].campaign.campaign_model | String | 否 | 业务字段 campaign_model | daily:持续推广,order:套餐包 |
| solution_command_list_v_o.solution_list[].campaign.promotion_model | String | 否 | 业务字段 promotion_model | daily:持续推广,order:套餐包 |
| solution_command_list_v_o.solution_list[].campaign.promotion_scene | String | 否 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd |
| solution_command_list_v_o.solution_list[].campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy；枚举：new_ad_similar=新品跟爆、competition_shopnew=竞争拉新、advantage_attack=优势进攻、lose_defend=流失防守、similar_item=相似品跟投 | new_ad_similar |
| solution_command_list_v_o.solution_list[].campaign.promotion_service | String | 否 | 业务字段 promotion_service；枚举：video_make=视频制作、video_editing=视频剪辑、ai_video_generation=ai算法生成视频 | video_make |
| solution_command_list_v_o.solution_list[].campaign.promotion_goals | String | 否 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd |
| solution_command_list_v_o.solution_list[].campaign.optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| solution_command_list_v_o.solution_list[].campaign.dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| solution_command_list_v_o.solution_list[].campaign.day_budget | Number | 否 | 日预算 | 100 |
| solution_command_list_v_o.solution_list[].campaign.reap_all_budget | String | 否 | 业务字段 reap_all_budget | 1000 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list | CrowdRefCommandVO [] | 否 | 人群操作列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.reap_crowd_ref_command_v_o_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| solution_command_list_v_o.solution_list[].campaign.total_budget | Number | 否 | 累计预算 | 100 |
| solution_command_list_v_o.solution_list[].campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| solution_command_list_v_o.solution_list[].campaign.budget_period | Number | 否 | 业务字段 budget_period | 7 |
| solution_command_list_v_o.solution_list[].campaign.period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| solution_command_list_v_o.solution_list[].campaign.bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].campaign.constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| solution_command_list_v_o.solution_list[].campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| solution_command_list_v_o.solution_list[].campaign.cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| solution_command_list_v_o.solution_list[].campaign.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].campaign.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].campaign.sub_promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| solution_command_list_v_o.solution_list[].campaign.promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| solution_command_list_v_o.solution_list[].campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| solution_command_list_v_o.solution_list[].campaign.item_rec_strategy_list | String [] | 否 | 商品集合 | ["effect_gmv","effect_coll"] |
| solution_command_list_v_o.solution_list[].campaign.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| solution_command_list_v_o.solution_list[].campaign.shield_items | Number [] | 否 | 业务字段 shield_items | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.scope_items | Number [] | 否 | 业务字段 scope_items | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.main_pic_video | String | 否 | 业务字段 main_pic_video | 1 |
| solution_command_list_v_o.solution_list[].campaign.auto_wang_wang_pic | String | 否 | 业务字段 auto_wang_wang_pic | 1 |
| solution_command_list_v_o.solution_list[].campaign.creative_optimization | String | 否 | 业务字段 creative_optimization；枚举：black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | black_creative |
| solution_command_list_v_o.solution_list[].campaign.creative_set_mode | String | 否 | 业务字段 creative_set_mode；枚举：minimalist=极简版、professional=专业版 | professional |
| solution_command_list_v_o.solution_list[].campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["1","19"] 或者 ["all"] |
| solution_command_list_v_o.solution_list[].campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.shield_categories | CategoryCommandVO [] | 否 | 业务集合 | — |
| solution_command_list_v_o.solution_list[].campaign.shield_categories[].cat_id | Number | 否 | 业务对象标识 | 35 |
| solution_command_list_v_o.solution_list[].campaign.shield_categories[].cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list | TrendThemeCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list[].trend_theme_id | Number | 否 | 业务对象标识 | 566987194 |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list[].trend_theme_name | String | 否 | 业务字段 trend_theme_name | 无边发光字 |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_auto_update | Number | 否 | 业务字段 trend_theme_auto_update | 10 |
| solution_command_list_v_o.solution_list[].campaign.trend_type | Number | 否 | 业务字段 trend_type | 10 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_type | String | 否 | 业务字段 launch_period_type | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| solution_command_list_v_o.solution_list[].campaign.spot_continue | Number | 否 | 业务字段 spot_continue | 1 |
| solution_command_list_v_o.solution_list[].campaign.only_spot | Number | 否 | 业务字段 only_spot | 0 |
| solution_command_list_v_o.solution_list[].campaign.mini_detail | CampaignMiniDetailCommandVO | 否 | 业务对象 | — |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.mini_detail_theme | String | 否 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_top_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203] |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_type | Number | 否 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list | CampaignCrowdFilterVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list[].behavior | String | 否 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list[].window | String | 否 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
| solution_command_list_v_o.solution_list[].campaign.shield_words | String [] | 否 | 业务字段 shield_words | Top,Pub |
| solution_command_list_v_o.solution_list[].campaign.shield_center_words | String [] | 否 | 业务字段 shield_center_words | Top,Pub |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words | WordCommandVO [] | 否 | 计划集合 | — |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].word | String | 否 | 词 | 鞋原创小众 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].bid_price | String | 否 | 出价金额 | 2.23 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.campaign_shield_words[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list | CampaignBrandFilterVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list[].brand_id | String | 否 | 业务对象标识 | 20067 |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list[].deeplink_list | String [] | 否 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list | DeeplinkBrandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list[].deeplink_brand_id | String | 否 | 业务对象标识 | 20067 |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list[].deeplink_brand_name | String | 否 | 业务字段 deeplink_brand_name | Lancome/兰蔻 |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list | CampaignGenderAgeFilterVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list[].gender | String | 否 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list[].age_list | String [] | 否 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] |
| solution_command_list_v_o.solution_list[].campaign.category_crowd_type | String | 否 | 业务字段 category_crowd_type；枚举：0=全域拉新、1=同类目拉新、2=跨类目拉新、7=OAI人群 | 0 |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o | VideoMakeInfoVO | 否 | 视频对象 | — |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.type | Number | 否 | 类型；枚举：1、2=视频剪辑 | 10 |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.material_contacter | String | 否 | 业务字段 material_contacter | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_requirement | String | 否 | 业务字段 video_requirement | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.item_selling_point | String | 否 | 业务字段 item_selling_point | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os | VideoMaterialVO [] | 否 | 视频素材集合 | — |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].id | Number | 否 | 对象标识 | 3 |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].image_url | String | 否 | 业务字段 image_url | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].height | Number | 否 | 业务字段 height | 10 |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].width | Number | 否 | 业务字段 width | 10 |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].title | String | 否 | 展示标题 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.video_material_v_os[].link_url | String | 否 | 业务字段 link_url | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_make_info_v_o.make_status | String | 否 | 业务字段 make_status | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_requirement | String | 否 | 业务字段 video_requirement | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.item_selling_point | String | 否 | 业务字段 item_selling_point | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_material_list | VideoMaterialVO [] | 否 | 视频素材列表 | — |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].id | Number | 否 | 对象标识 | 3 |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].image_url | String | 否 | 业务字段 image_url | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].height | Number | 否 | 业务字段 height | 10 |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].width | Number | 否 | 业务字段 width | 10 |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].title | String | 否 | 展示标题 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.video_material_list[].link_url | String | 否 | 业务字段 link_url | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| solution_command_list_v_o.solution_list[].campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list | CrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.competition_crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list | CrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.black_crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd | CrowdRefCommandVO | 否 | 人群对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.target_crowd | String | 否 | 目标人群；枚举：ShopNew=店铺新客、brandNew=品牌新客 | ShopNew |
| solution_command_list_v_o.solution_list[].campaign.scene_target | String | 否 | 业务字段 scene_target；枚举：InShopNew=新客访问、InterestNew=新客兴趣加深、BuyNew=新客成交 | BuyNew |
| solution_command_list_v_o.solution_list[].campaign.source_channel | String | 否 | 业务字段 source_channel | adStrategyDurationPC |
| solution_command_list_v_o.solution_list[].campaign.channel_location | String | 否 | 业务字段 channel_location | marketing_increasetraffic |
| solution_command_list_v_o.solution_list[].campaign.source_platform | String | 否 | 业务字段 source_platform | light |
| solution_command_list_v_o.solution_list[].campaign.speed_type | String | 否 | 业务字段 speed_type | smooth |
| solution_command_list_v_o.solution_list[].campaign.exposure_time | Number | 否 | 业务字段 exposure_time | 2 |
| solution_command_list_v_o.solution_list[].campaign.coupon_id | Number | 否 | 业务对象标识 | 121528977 |
| solution_command_list_v_o.solution_list[].campaign.plan_id | Number | 否 | 业务对象标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.plan_template_id | Number | 否 | 模板标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| solution_command_list_v_o.solution_list[].campaign.package_id | Number | 否 | 业务对象标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.order_info | CampaignOrderInfoVO | 否 | 业务对象 | — |
| solution_command_list_v_o.solution_list[].campaign.order_info.plan_id | Number | 否 | 业务对象标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.order_info.plan_name | String | 否 | 业务字段 plan_name | 测试 |
| solution_command_list_v_o.solution_list[].campaign.order_info.order_amount | String | 否 | 业务字段 order_amount | 0.01 |
| solution_command_list_v_o.solution_list[].campaign.order_info.order_video_make_amount | String | 否 | 业务字段 order_video_make_amount | 0.01 |
| solution_command_list_v_o.solution_list[].campaign.order_info.launch_time_type | String | 否 | 业务字段 launch_time_type | stableTime |
| solution_command_list_v_o.solution_list[].campaign.order_info.start_date | String | 否 | 开始日期 | 2024-09-09 |
| solution_command_list_v_o.solution_list[].campaign.order_info.end_date | String | 否 | 结束日期 | 2099-01-01 |
| solution_command_list_v_o.solution_list[].campaign.order_info.predict_cycle | Number | 否 | 业务字段 predict_cycle | 7 |
| solution_command_list_v_o.solution_list[].campaign.order_info.max_period | Number | 否 | 业务字段 max_period | 30 |
| solution_command_list_v_o.solution_list[].campaign.order_info.min_period | Number | 否 | 业务字段 min_period | 3 |
| solution_command_list_v_o.solution_list[].campaign.order_info.min_start_limit_offset | Number | 否 | 业务字段 min_start_limit_offset | 8 |
| solution_command_list_v_o.solution_list[].campaign.order_info.activity_id | Number | 否 | 业务对象标识 | 180 |
| solution_command_list_v_o.solution_list[].campaign.order_info.order_limit | Number | 否 | 业务字段 order_limit | 10 |
| solution_command_list_v_o.solution_list[].campaign.order_info.total_stock | Number | 否 | 业务字段 total_stock | 30 |
| solution_command_list_v_o.solution_list[].campaign.order_info.pv | Number | 否 | 业务字段 pv | 10000 |
| solution_command_list_v_o.solution_list[].campaign.order_info.limit_video_scope | String | 否 | 业务字段 limit_video_scope | 1 |
| solution_command_list_v_o.solution_list[].campaign.order_charge_type | String | 否 | 业务字段 order_charge_type | pc_direct_charge |
| solution_command_list_v_o.solution_list[].campaign.coupon_amount | String | 否 | 业务字段 coupon_amount | 50 |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| solution_command_list_v_o.solution_list[].campaign.is_budget_schedule_open | Boolean | 否 | 业务字段 is_budget_schedule_open | true |
| solution_command_list_v_o.solution_list[].campaign.market_aim_type | String | 否 | 业务字段 market_aim_type；枚举：fixed_target=固定目标、auto_trans=自动流转 | fixed_target |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate | LaunchDateFeeRateVO [] | 否 | 日期集合 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].start_date | String | 否 | 开始日期 | 2023-06-09 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].end_date | String | 否 | 结束日期 | 2023-06-19 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].stress_start_date_time | String | 否 | 业务字段 stress_start_date_time | 2025-06-28 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].stress_end_date_time | String | 否 | 业务字段 stress_end_date_time | 2025-06-28 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].fee_rate | String | 否 | 业务字段 fee_rate | 20 |
| solution_command_list_v_o.solution_list[].campaign.launch_date_fee_rate[].day_budget | String | 否 | 日预算 | 1000 |
| solution_command_list_v_o.solution_list[].campaign.search_detent_type | String | 否 | 业务字段 search_detent_type | first_place |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list | AdgroupCommandVO [] | 否 | 单元列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | 物料名称 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].title | String | 否 | 展示标题 | 物料标题 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].link_url | String | 否 | 业务字段 link_url | https://h5.m.taobao.com/****timemove |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/******.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].live_id | Number | 否 | 业务对象标识 | 474297730705 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].live_title | String | 否 | 业务字段 live_title | 直播间隔一小时抽免单 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].material_id | Number | 否 | 素材标识 | 474847464897 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].status | Number | 否 | 状态标识 | 4 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].material_type | Number | 否 | 素材类型 | 3 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].audit_reason | String | 否 | 业务字段 audit_reason | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].material_tag_id | Number | 否 | 素材标识 | 40 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].quantity | Number | 否 | 业务字段 quantity | 20 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].bid_count | Number | 否 | 出价数量 | 20 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].item_id | Number | 否 | 商品编号 | 474847464777 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].outer_status | Number | 否 | 业务字段 outer_status | 10 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].live_cover_img | String | 否 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].audit_status | Number | 否 | 业务字段 audit_status | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].live_start_time | Date | 否 | 业务字段 live_start_time | 2024-08-02 07:44:22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].video_ori_url | String | 否 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].pv | Number | 否 | 业务字段 pv | 35 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].trade_amt | Number | 否 | 业务字段 trade_amt | 147 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].live_start_time_str | String | 否 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].increment_status | Number | 否 | 业务字段 increment_status | 0 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].increment_budget | Number | 否 | 业务字段 increment_budget | 100 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].abnormal_flow_filter | Number | 否 | 业务字段 abnormal_flow_filter | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_properties | String | 否 | 业务字段 image_properties | 251005701:5342939018 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].is_special_size | String | 否 | 业务字段 is_special_size | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |
| solution_command_list_v_o.solution_list[].campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| solution_command_list_v_o.solution_list[].campaign.more_campaign_switch | Boolean | 否 | 业务字段 more_campaign_switch | false |
| solution_command_list_v_o.solution_list[].campaign.conv | Number | 否 | 业务字段 conv | 10 |
| solution_command_list_v_o.solution_list[].campaign.common_filters | String | 否 | 业务字段 common_filters | — |
| solution_command_list_v_o.solution_list[].campaign.smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_extend_type | String | 否 | 业务字段 crowd_extend_type | auto |
| solution_command_list_v_o.solution_list[].campaign.whole_member_ship | Boolean | 否 | 业务字段 whole_member_ship | false |
| solution_command_list_v_o.solution_list[].campaign.crowd_custom_type | Boolean | 否 | 业务字段 crowd_custom_type | false |
| solution_command_list_v_o.solution_list[].campaign.creative_skin | String | 否 | 业务字段 creative_skin | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| solution_command_list_v_o.solution_list[].campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| solution_command_list_v_o.solution_list[].campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| solution_command_list_v_o.solution_list[].campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| solution_command_list_v_o.solution_list[].campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| solution_command_list_v_o.solution_list[].campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| solution_command_list_v_o.solution_list[].campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| solution_command_list_v_o.solution_list[].adgroup_list | AdgroupCommandVO [] | 是 | 单元列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 否 | 业务字段 ocpc_marketing_aim；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、new_item=新品冷启动、new_ad=新广告加速、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量 | click |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | 物料名称 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].title | String | 否 | 展示标题 | 物料标题 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].link_url | String | 否 | 业务字段 link_url | https://h5.m.taobao.com/****timemove |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/******.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].live_id | Number | 否 | 业务对象标识 | 474297730705 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].live_title | String | 否 | 业务字段 live_title | 直播间隔一小时抽免单 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].material_id | Number | 否 | 素材标识 | 474847464897 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].status | Number | 否 | 状态标识 | 4 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].material_type | Number | 否 | 素材类型 | 3 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].audit_reason | String | 否 | 业务字段 audit_reason | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].material_tag_id | Number | 否 | 素材标识 | 40 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].quantity | Number | 否 | 业务字段 quantity | 20 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].bid_count | Number | 否 | 出价数量 | 20 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].item_id | Number | 否 | 商品编号 | 474847464777 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].outer_status | Number | 否 | 业务字段 outer_status | 10 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].live_cover_img | String | 否 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].audit_status | Number | 否 | 业务字段 audit_status | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].live_start_time | Date | 否 | 业务字段 live_start_time | 2024-08-02 07:44:22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].video_ori_url | String | 否 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].pv | Number | 否 | 业务字段 pv | 35 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].trade_amt | Number | 否 | 业务字段 trade_amt | 147 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].live_start_time_str | String | 否 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].increment_status | Number | 否 | 业务字段 increment_status | 0 |
| solution_command_list_v_o.solution_list[].adgroup_list[].increment_budget | Number | 否 | 业务字段 increment_budget | 100 |
| solution_command_list_v_o.solution_list[].adgroup_list[].abnormal_flow_filter | Number | 否 | 业务字段 abnormal_flow_filter | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_properties | String | 否 | 业务字段 image_properties | 251005701:5342939018 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].is_special_size | String | 否 | 业务字段 is_special_size | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_solution_addlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_solution_addlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_solution_addlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_solution_addlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_solution_addlist_response.top_result.info.error_code |
| top_result.solution_add_result_v_o_top_part_data | TopPartData | 未标注 | 结果对象 | — | universalbp_new_solution_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_solution_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_solution_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_solution_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_solution_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_solution_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 | 未标注 | 素材标识 | 479056881525 | universalbp_new_solution_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_solution_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_solution_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_solution_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_solution_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_solution_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_solution_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 | 未标注 | 素材标识 | 479056881525 | universalbp_new_solution_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.solution.addlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "solution_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

签名阶段错误读取奇门云 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_solution_addlist_response.top_result.solution_add_result_v_o_top_part_data.error_details）

来源校验 SHA256：1cd556145fc39a6cae8f6952ad65a50461911d460647a9f521dfe0098fdd957d



---

# 批量更新计划预算

`taobao.universalbp.new.campaign.budget.batchupdate`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_budget_list_v_o | CampaignBudgetListVO | 是 | 计划预算变更对象 | — |
| campaign_budget_list_v_o.budget_list | CampaignBudgetCommandVO [] | 是 | 预算变更项目 | — |
| campaign_budget_list_v_o.budget_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_budget_list_v_o.budget_list[].dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| campaign_budget_list_v_o.budget_list[].day_budget | Number | 否 | 日预算 | 100 |
| campaign_budget_list_v_o.budget_list[].smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| campaign_budget_list_v_o.budget_list[].total_budget | Number | 否 | 累计预算 | 100 |
| campaign_budget_list_v_o.budget_list[].period_smooth | String | 否 | 业务字段 period_smooth | 7 |
| campaign_budget_list_v_o.budget_list[].launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| campaign_budget_list_v_o.budget_list[].launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| campaign_budget_list_v_o.budget_list[].launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| campaign_budget_list_v_o.budget_list[].launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data | BudgetScheduleDataSiteVO | 否 | 预算对象 | — |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_type | String | 否 | 业务字段 activity_type；枚举：OFFICAL=官方活动、CUSTOM=自定义活动 | OFFICAL |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.main_activity | TmcCampaignVO | 否 | 业务对象 | — |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.main_activity.id | Number | 否 | 对象标识 | 1 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.main_activity.name | String | 否 | 对象名称 | 活动期 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.main_activity.start_time | String | 否 | 查询或投放起始时间 | 2023-07-05 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.main_activity.end_time | String | 否 | 查询或投放结束时间 | 2023-07-14 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.schedule_type | String | 否 | 业务字段 schedule_type；枚举：AUTO=智能分配、STAGE=按阶段分配 | AUTO |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list | ActivityBudgetVO [] | 否 | 预算列表集合 | — |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list[].id | Number | 否 | 对象标识 | 1 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list[].name | String | 否 | 对象名称 | 活动期 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-07-05 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-07-14 |
| campaign_budget_list_v_o.budget_list[].budget_schedule_data.activity_budget_list[].activity_dmc | Number | 否 | 业务字段 activity_dmc | 510 |
| campaign_budget_list_v_o.budget_list[].is_budget_schedule_open | Boolean | 否 | 业务字段 is_budget_schedule_open | true |
| campaign_budget_list_v_o.budget_list[].multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| campaign_budget_list_v_o.budget_list[].multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| campaign_budget_list_v_o.budget_list[].multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| campaign_budget_list_v_o.budget_list[].multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| campaign_budget_list_v_o.budget_list[].multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| campaign_budget_list_v_o.budget_list[].quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| campaign_budget_list_v_o.budget_list[].quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| campaign_budget_list_v_o.budget_list[].quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| campaign_budget_list_v_o.budget_list[].quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| campaign_budget_list_v_o.budget_list[].quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all |

## 响应业务字段

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

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.campaign_budget_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_budget_batchupdate_response.top_result.campaign_budget_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：ceccd7ffed5a98183438f5dbfaf441e67ce72b2086816588755bc6c4b5fb523f



---

# 批量更新计划出价

`taobao.universalbp.new.campaign.bid.batchupdate`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_bid_list_v_o | CampaignBidListVO | 是 | 计划出价列表 | — |
| campaign_bid_list_v_o.bid_list | CampaignBidCommandVO [] | 是 | 出价列表 | — |
| campaign_bid_list_v_o.bid_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| campaign_bid_list_v_o.bid_list[].cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| campaign_bid_list_v_o.bid_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| campaign_bid_list_v_o.bid_list[].constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| campaign_bid_list_v_o.bid_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| campaign_bid_list_v_o.bid_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_list_v_o.bid_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_bid_list_v_o.bid_list[].crowd_discount | Number | 否 | 业务字段 crowd_discount | 30 |
| campaign_bid_list_v_o.bid_list[].word_price | String | 否 | 词金额 | 30 |
| campaign_bid_list_v_o.bid_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_bid_list_v_o.bid_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_bid_list_v_o.bid_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |

## 响应业务字段

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

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.campaign_bid_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_bid_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：8b3aff0bb9f897c8bfdda63229da17e1a8cd923d32549c961be710c49a467f74



---

# 预览算法优选的商品信息

`taobao.universalbp.new.material.intelligentpreshow`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| item_query_v_o | ItemQueryVO | 是 | 商品查询 | — |
| item_query_v_o.item_id_list | Number [] | 否 | 商品标识列表 | [714894818852, 714901906337] |
| item_query_v_o.tag_id | Number | 否 | 业务对象标识；枚举：1=全部宝贝、2=推荐宝贝、3=活动宝贝、4=有好货宝贝、5=图文、6=有好货帖子、7=直播、8=淘积木、9=短视频、10=图文手猜、11=可用津贴券商品、12=全部新品、13=618活动商品、14=可用店铺券宝贝、15=推荐新品、16=首页新品推荐、20=首页推荐、21=图文V任务、22=短视频V任务、23=直播V任务、25=店铺微淘、26=直播合作、24=落地页、27=活动商品、28=首页大促商品、29=投中探测爆款商品、30=已报名的新享宝贝、31=店铺视频、32=包含单元宝贝的淘积木列表、34=达人视频、33=不计入最低价新品、35=首猜精品库、36=首猜精品中的新品、37=行业优选、38=大促推荐新品、39、40=效果优选、41=潜力爆品、42=全店成长、43=双11、44=推广有礼、49=新品飞车数据、50=效果优选、53=全店优选二期、55=首单礼金、56=新品直降、57=限时优惠、58=618大促、59=扩容后新品飞车商品池、101=全部、102、103、104、105、106=生意参谋-物流红包、1000=组件tag开始index、1999=组件tag结束、209=策略中心货品加速单品、201=策略中心推荐宝贝、202=策略中心推荐相似宝贝、203=策略中心智能营销推荐宝贝、204=策略中心大快消TOP单品、205=策略中心新享报名商品、206=策略中心未报名商品、207=策略中心上新单品、214=策略中心上新礼、224=策略中心小黑盒上新、212=策略中心产业带单品、210=策略中心货品加速新的tag、211=策略中心货品加速版本2、213=策略中心大快消入会快、215=策略中心大快消留资快、216=策略中心大快消派样快、219=策略中心大快消预热蓄水、217=策略中心大快消爆发现货、218=策略中心大快消爆发预售、220=策略中心大快消测款、221=策略中心销量明星商品、222=策略中心测款均匀曝光、223=策略中心大测款均匀预算、225=策略中心上新数智经营争霸赛、226=策略中心货品加速数智经营争霸赛、227=策略中心数预热蓄水智经营争霸赛、228=策略中心爆发现货数智经营争霸赛、229=策略中心爆发预售数智经营争霸赛、230=策略中心大快消数智经营争霸赛、1016001=系统优选、1016002=相似宝贝、1100001=极速推宝贝推荐、101111301=冷启动新品、101111302=好货推荐、101111303=趋势主题选品 | 1 |
| item_query_v_o.title | String | 否 | 展示标题 | 测试 |
| item_query_v_o.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 |
| item_query_v_o.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 |
| item_query_v_o.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| item_query_v_o.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| item_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| item_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_material_intelligentpreshow_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_material_intelligentpreshow_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_material_intelligentpreshow_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_material_intelligentpreshow_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_material_intelligentpreshow_response.top_result.info.error_code |
| top_result.item_v_o_top_bulk_data | TopBulkData | 未标注 | 商品对象 | — | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data |
| top_result.item_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.count |
| top_result.item_v_o_top_bulk_data.item_v_o_list | ItemVO [] | 未标注 | 商品列表 | — | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].item_id | Number | 未标注 | 商品编号 | 714707465203 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].item_id |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].title | String | 未标注 | 展示标题 | 测试商品_请不要拍_夏季连衣裙，1 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].title |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i4/2212778286564/O1CN018hQuTY1yMMbmQD13V_!!2212778286564.jpg | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].img_url |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=714707465203 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].link_url |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].price | Number | 未标注 | 金额 | 899900 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].price |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].bid_count | Number | 未标注 | 出价数量 | 899900 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].bid_count |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].quantity | Number | 未标注 | 业务字段 quantity | 10 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].quantity |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].first_starts_time |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].starts |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].category_id | String | 未标注 | 业务对象标识 | 16 50010850 | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].category_id |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].timing | Boolean | 未标注 | 业务字段 timing；枚举：true=是、false=否 | false | universalbp_new_material_intelligentpreshow_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].timing |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.material.intelligentpreshow",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "item_query_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.material.intelligentpreshow\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"item_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：b194f21f0a2649b67afd826941be9f9b77310c630805ad6a0d17998a9c2df032



---

# 修改单元或主体状态

`taobao.universalbp.new.adgroup.updatepart`

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

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

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

## 请求业务字段

路径均位于本站 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_update_part_list_v_o | AdgroupUpdatePartListVO | 是 | 单元列表对象 | — |
| adgroup_update_part_list_v_o.adgroup_list | AdgroupUpdatePartCommandVO [] | 是 | 单元列表 | — |
| adgroup_update_part_list_v_o.adgroup_list[].campaign_id | Number | 是 | 推广计划编号 | 68796878069 |
| adgroup_update_part_list_v_o.adgroup_list[].adgroup_id | Number | 是 | 推广单元编号 | 68793666608 |
| adgroup_update_part_list_v_o.adgroup_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| adgroup_update_part_list_v_o.adgroup_list[].display_status | String | 否 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause |
| adgroup_update_part_list_v_o.adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative；枚举：0=关闭、1=开启 | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adgroup_updatepart_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adgroup_updatepart_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adgroup_updatepart_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adgroup_updatepart_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adgroup_updatepart_response.top_result.info.error_code |
| top_result.adgroup_v_o_top_bulk_data | TopBulkData | 未标注 | 单元对象 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data |
| top_result.adgroup_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.count |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list | AdgroupVO [] | 未标注 | 单元列表 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].campaign_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].campaign_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].online_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].display_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-1=待审核、0=后台下线状态、1=后台上线状态 | 1 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].audit_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | xxxxx | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].audit_reason |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc | AdgroupOcpcVO | 未标注 | 单元对象 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.enable_ocpc | Boolean | 未标注 | 业务字段 enable_ocpc；枚举：false=否、true=是 | true | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.enable_ocpc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.ocpc_ratio |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].sub_promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material | CommonMaterialVO | 未标注 | 素材 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_type | Number | 未标注 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.title |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.img_url |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.link_url |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.price | String | 未标注 | 金额 | 999900 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.price |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.bid_count | Number | 未标注 | 出价数量 | 899900 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.bid_count |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.quantity | Number | 未标注 | 业务字段 quantity | 10 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.quantity |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.first_starts_time |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.starts |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.category_id | String | 未标注 | 业务对象标识 | 16 50010850 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.category_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_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 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.sub_promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list | ItemLifeCycleViewVO [] | 未标注 | 列表集合；列表中最多有2个元素 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].life_cycle_desc | String | 未标注 | 业务字段 life_cycle_desc | 新品打爆期 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].life_cycle_desc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].color | String | 未标注 | 业务字段 color | #36A2FC | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].color |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].tips | String | 未标注 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].tips |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].type | Number | 未标注 | 类型 | 1 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_days | Number | 未标注 | 业务字段 life_cycle_days | 3 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_days |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_diff_with_avg | String | 未标注 | 业务字段 life_cycle_diff_with_avg | 较慢 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_diff_with_avg |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_diff_with_avg_tips | String | 未标注 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_diff_with_avg_tips |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.grow_desc | String | 未标注 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.grow_desc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.grow_rank | Number | 未标注 | 业务字段 grow_rank | 1077 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.grow_rank |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].alive_group_id | Number | 未标注 | 业务对象标识；枚举：0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].alive_group_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].alive_group_name | String | 未标注 | 业务字段 alive_group_name | 宝贝链接(默认) | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].alive_group_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].black_creative_status | String | 未标注 | 业务字段 black_creative_status；枚举：success=合成成功、fail=合成失败 | success | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].black_creative_status |
| top_result.adgroup_v_o_top_bulk_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_count |
| top_result.adgroup_v_o_top_bulk_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details |
| top_result.adgroup_v_o_top_bulk_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details.top_fail_result[].code |
| top_result.adgroup_v_o_top_bulk_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details.top_fail_result[].msg |
| top_result.adgroup_v_o_top_bulk_data.error_details[].result | AdgroupVO | 未标注 | 执行结果内容 | — | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details.top_fail_result[].result |
| top_result.adgroup_v_o_top_bulk_data.error_details[].result.adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details.top_fail_result[].result.adgroup_id |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.adgroup_v_o_top_bulk_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_adgroup_updatepart_response.top_result.adgroup_v_o_top_bulk_data.error_details）

来源校验 SHA256：37c5be33d33accfea0420a42cac471157ce566c69dc957763f4970694c9b3b40



---

# 删除单元或主体

`taobao.universalbp.new.adgroup.delete`

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

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

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

## 请求业务字段

路径均位于本站 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_delete_list_v_o | AdgroupDeleteListVO | 是 | 单元列表对象 | — |
| adgroup_delete_list_v_o.adgroup_list | AdgroupDeleteVO [] | 是 | 单元列表 | — |
| adgroup_delete_list_v_o.adgroup_list[].campaign_id | Number | 是 | 推广计划编号 | 68796878069 |
| adgroup_delete_list_v_o.adgroup_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| adgroup_delete_list_v_o.adgroup_list[].adgroup_id | Number | 是 | 推广单元编号 | 68793666608 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adgroup_delete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adgroup_delete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adgroup_delete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adgroup_delete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adgroup_delete_response.top_result.info.error_code |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：1528ff542e72c6f5bb55d3b9091ed0276a7f6710a7e461f8054289b3611c4fbe



---

# 查询可用品牌列表

`taobao.universalbp.new.member.findbrandinfolist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_member_findbrandinfolist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_member_findbrandinfolist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_member_findbrandinfolist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_member_findbrandinfolist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_member_findbrandinfolist_response.top_result.info.error_code |
| top_result.brand_info_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_member_findbrandinfolist_response.top_result.brand_info_v_o_top_bulk_data |
| top_result.brand_info_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_member_findbrandinfolist_response.top_result.brand_info_v_o_top_bulk_data.count |
| top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list | BrandInfoVO [] | 未标注 | 列表集合 | — | universalbp_new_member_findbrandinfolist_response.top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list |
| top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list[].brand_id | String | 未标注 | 业务对象标识 | 200341 | universalbp_new_member_findbrandinfolist_response.top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list.brand_info_v_o[].brand_id |
| top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list[].brand_name | String | 未标注 | 业务字段 brand_name | Es1te Lauder/雅兰黛 | universalbp_new_member_findbrandinfolist_response.top_result.brand_info_v_o_top_bulk_data.brand_info_v_o_list.brand_info_v_o[].brand_name |

## 本站请求结构

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

```json

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

```

## 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.member.findbrandinfolist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：cbcf564668299bbfeb04d61786f01ba0c3a9a72fa0a098b682f1baa002603a8e



---

# 获取店铺信息

`taobao.universalbp.new.material.shop.get`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_material_shop_get_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_material_shop_get_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_material_shop_get_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_material_shop_get_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_material_shop_get_response.top_result.info.error_code |
| top_result.shop_info_v_o | ShopInfoVO | 未标注 | 店铺对象 | — | universalbp_new_material_shop_get_response.top_result.shop_info_v_o |
| top_result.shop_info_v_o.shop_id | Number | 未标注 | 店铺编号 | 460418344 | universalbp_new_material_shop_get_response.top_result.shop_info_v_o.shop_id |
| top_result.shop_info_v_o.title | String | 未标注 | 展示标题 | d[s460418344] | universalbp_new_material_shop_get_response.top_result.shop_info_v_o.title |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.material.shop.get",
  "params": {
    "top_service_context": {
      "biz_code": "onebpSite",
      "login_type": 1,
      "ext": "{}"
    }
  }
}

```

## 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.material.shop.get\",\"params\":{\"top_service_context\":{\"biz_code\":\"onebpSite\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：d46f581de18430c542376fc13949a990f2d7fb24409630ef2bd3adb0f162f37e



---

# 分页查询商品信息

`taobao.universalbp.new.material.item.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| item_query_v_o | ItemQueryVO | 是 | 商品查询 | — |
| item_query_v_o.item_id_list | Number [] | 否 | 商品标识列表 | [714894818852, 714901906337] |
| item_query_v_o.tag_id | Number | 否 | 业务对象标识；枚举：1=全部宝贝、2=推荐宝贝、3=活动宝贝、4=有好货宝贝、5=图文、6=有好货帖子、7=直播、8=淘积木、9=短视频、10=图文手猜、11=可用津贴券商品、12=全部新品、13=618活动商品、14=可用店铺券宝贝、15=推荐新品、16=首页新品推荐、20=首页推荐、21=图文V任务、22=短视频V任务、23=直播V任务、25=店铺微淘、26=直播合作、24=落地页、27=活动商品、28=首页大促商品、29=投中探测爆款商品、30=已报名的新享宝贝、31=店铺视频、32=包含单元宝贝的淘积木列表、34=达人视频、33=不计入最低价新品、35=首猜精品库、36=首猜精品中的新品、37=行业优选、38=大促推荐新品、39、40=效果优选、41=潜力爆品、42=全店成长、43=双11、44=推广有礼、49=新品飞车数据、50=效果优选、53=全店优选二期、55=首单礼金、56=新品直降、57=限时优惠、58=618大促、59=扩容后新品飞车商品池、101=全部、102、103、104、105、106=生意参谋-物流红包、1000=组件tag开始index、1999=组件tag结束、209=策略中心货品加速单品、201=策略中心推荐宝贝、202=策略中心推荐相似宝贝、203=策略中心智能营销推荐宝贝、204=策略中心大快消TOP单品、205=策略中心新享报名商品、206=策略中心未报名商品、207=策略中心上新单品、214=策略中心上新礼、224=策略中心小黑盒上新、212=策略中心产业带单品、210=策略中心货品加速新的tag、211=策略中心货品加速版本2、213=策略中心大快消入会快、215=策略中心大快消留资快、216=策略中心大快消派样快、219=策略中心大快消预热蓄水、217=策略中心大快消爆发现货、218=策略中心大快消爆发预售、220=策略中心大快消测款、221=策略中心销量明星商品、222=策略中心测款均匀曝光、223=策略中心大测款均匀预算、225=策略中心上新数智经营争霸赛、226=策略中心货品加速数智经营争霸赛、227=策略中心数预热蓄水智经营争霸赛、228=策略中心爆发现货数智经营争霸赛、229=策略中心爆发预售数智经营争霸赛、230=策略中心大快消数智经营争霸赛、1016001=系统优选、1016002=相似宝贝、1100001=极速推宝贝推荐、101111301=冷启动新品、101111302=好货推荐、101111303=趋势主题选品、101111501=短视频爆品、101111502=短视频新品、101111503=短视频助推 | 1 |
| item_query_v_o.title | String | 否 | 展示标题 | 测试 |
| item_query_v_o.shop_category_id | Number | 否 | 店铺标识 | 1714177721 |
| item_query_v_o.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 |
| item_query_v_o.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 |
| item_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 69340883646 |
| item_query_v_o.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| item_query_v_o.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| item_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68796878069] |
| item_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| item_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| item_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| item_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| item_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| item_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| item_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| item_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| item_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| item_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| item_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_material_item_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_material_item_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_material_item_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_material_item_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_material_item_findpage_response.top_result.info.error_code |
| top_result.item_v_o_top_bulk_data | TopBulkData | 未标注 | 商品对象 | — | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data |
| top_result.item_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.count |
| top_result.item_v_o_top_bulk_data.item_v_o_list | ItemVO [] | 未标注 | 商品列表 | — | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].item_id | Number | 未标注 | 商品编号 | 714707465203 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].item_id |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].title | String | 未标注 | 展示标题 | 测试商品_请不要拍_夏季连衣裙，1 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].title |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i4/2212778286564/O1CN018hQuTY1yMMbmQD13V_!!2212778286564.jpg | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].img_url |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=714707465203 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].link_url |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].price | Number | 未标注 | 金额 | 899900 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].price |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].bid_count | Number | 未标注 | 出价数量 | 899900 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].bid_count |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].quantity | Number | 未标注 | 业务字段 quantity | 10 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].quantity |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].first_starts_time |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].starts |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].category_id | String | 未标注 | 业务对象标识 | 16 50010850 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].category_id |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].timing | Boolean | 未标注 | 业务字段 timing；枚举：true=是、false=否 | false | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].timing |
| top_result.item_v_o_top_bulk_data.item_v_o_list[].category_level1 | String | 未标注 | 业务字段 category_level1 | 1625 | universalbp_new_material_item_findpage_response.top_result.item_v_o_top_bulk_data.item_v_o_list.item_v_o[].category_level1 |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.material.item.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "item_query_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.material.item.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"item_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：ffeed6c76f73d73bc7e0c0d25c361edecb30b7162c78b0df3a986716598cce66



---

# 物料准入判断

`taobao.universalbp.new.material.accessallowed`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| material_access_allow_query_v_o | MaterialAccessAllowQueryVO | 是 | 素材查询对象 | — |
| material_access_allow_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337] |
| material_access_allow_query_v_o.material_type | Number | 否 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 |
| material_access_allow_query_v_o.need_qualification | Boolean | 否 | 业务字段 need_qualification；枚举：true=校验、false=不校验 | true |
| material_access_allow_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| material_access_allow_query_v_o.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 |
| material_access_allow_query_v_o.package_id | String | 否 | 业务对象标识 | 8458782 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_material_accessallowed_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_material_accessallowed_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_material_accessallowed_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_material_accessallowed_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_material_accessallowed_response.top_result.info.error_code |
| top_result.material_access_allow_v_o_top_bulk_data | TopBulkData | 未标注 | 素材对象 | — | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data |
| top_result.material_access_allow_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data.count |
| top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list | MaterialAccessAllowVO [] | 未标注 | 素材列表集合 | — | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list |
| top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list.material_access_allow_v_o[].material_id |
| top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list[].access_allowed | Boolean | 未标注 | 业务字段 access_allowed；枚举：true=是、false=否 | true | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list.material_access_allow_v_o[].access_allowed |
| top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list[].reason | String | 未标注 | 业务字段 reason | 拒绝原因 | universalbp_new_material_accessallowed_response.top_result.material_access_allow_v_o_top_bulk_data.material_access_allow_v_o_list.material_access_allow_v_o[].reason |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.material.accessallowed",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "material_access_allow_query_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.material.accessallowed\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"material_access_allow_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：e74314821e8e958612633d2723474cb0bb91d92801b53ff74cdce07780f1479b



---

# 查询单元分页列表

`taobao.universalbp.new.adgroup.horizontal.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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_query_v_o | AdgroupQueryVO | 是 | 单元查询 | — |
| adgroup_query_v_o.status_list | String [] | 否 | 筛选状态集合 | [start] |
| adgroup_query_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68792788657] |
| adgroup_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| adgroup_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| adgroup_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| adgroup_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2025-10-08 |
| adgroup_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2025-10-08 |
| adgroup_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| adgroup_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| adgroup_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| adgroup_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| adgroup_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| adgroup_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| adgroup_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [70847259904] |
| adgroup_query_v_o.item_id | Number | 否 | 商品编号 | 806671599436 |
| adgroup_query_v_o.item_name_like | String | 否 | 业务字段 item_name_like | 自动化ttt1686测试请不要拍 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adgroup_horizontal_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adgroup_horizontal_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adgroup_horizontal_findpage_response.top_result.info.error_code |
| top_result.adgroup_v_o_top_bulk_data | TopBulkData | 未标注 | 单元对象 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data |
| top_result.adgroup_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.count |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list | AdgroupVO [] | 未标注 | 单元列表 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].campaign_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].campaign_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].online_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].display_status | String | 未标注 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].display_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-1=待审核、0=后台下线状态、1=后台上线状态 | 1 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].audit_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | xxxxx | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].audit_reason |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc | AdgroupOcpcVO | 未标注 | 单元对象 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.enable_ocpc | Boolean | 未标注 | 业务字段 enable_ocpc；枚举：false=否、true=是 | true | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.enable_ocpc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.ocpc_ratio | Number | 未标注 | 业务字段 ocpc_ratio | 200 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.ocpc_ratio |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.ocpc_marketing_aim | String | 未标注 | 业务字段 ocpc_marketing_aim | click | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.ocpc_marketing_aim |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.ocpc_status | String | 未标注 | 业务字段 ocpc_status；枚举：new_ad_openable=可开启新广告加速、new_item_openable=可开启新品冷启动、new_ad_speeding=新广告加速加速中、new_item_speeding=新品冷启动加速中、new_ad_complete=新广告加速加速完成、new_item_complete=新品冷启动加速完成 | new_ad_complete | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.ocpc_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.enable_cold_speed_new_item | Boolean | 未标注 | 业务字段 enable_cold_speed_new_item；枚举：true=是、false=否 | false | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.enable_cold_speed_new_item |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].adgroup_ocpc.ecpc_option | Number | 未标注 | 业务字段 ecpc_option | 1 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].adgroup_ocpc.ecpc_option |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].sub_promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material | CommonMaterialVO | 未标注 | 素材 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_type | Number | 未标注 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.material_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.title |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.img_url |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.link_url |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.price | String | 未标注 | 金额 | 999900 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.price |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.bid_count | Number | 未标注 | 出价数量 | 899900 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.bid_count |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.quantity | Number | 未标注 | 业务字段 quantity | 10 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.quantity |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.first_starts_time | Date | 未标注 | 业务字段 first_starts_time | 2023-04-26 14:51:03 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.first_starts_time |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.starts | Date | 未标注 | 业务字段 starts | 2023-04-26 14:51:03 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.starts |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.category_id | String | 未标注 | 业务对象标识 | 16 50010850 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.category_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_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 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.sub_promotion_type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list | ItemLifeCycleViewVO [] | 未标注 | 列表集合；列表中最多有2个元素 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].life_cycle_desc | String | 未标注 | 业务字段 life_cycle_desc | 新品打爆期 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].life_cycle_desc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].color | String | 未标注 | 业务字段 color | #36A2FC | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].color |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].tips | String | 未标注 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].tips |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_list[].type | Number | 未标注 | 类型 | 1 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_list.item_life_cycle_view_v_o[].type |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_days | Number | 未标注 | 业务字段 life_cycle_days | 3 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_days |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_diff_with_avg | String | 未标注 | 业务字段 life_cycle_diff_with_avg | 较慢 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_diff_with_avg |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.life_cycle_diff_with_avg_tips | String | 未标注 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.life_cycle_diff_with_avg_tips |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.grow_desc | String | 未标注 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.grow_desc |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.grow_rank | Number | 未标注 | 业务字段 grow_rank | 1077 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.grow_rank |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.short_v_items | ShortVItemVO [] | 未标注 | 业务集合 | — | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.short_v_items |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.short_v_items[].id | Number | 未标注 | 对象标识 | 662732732888 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.short_v_items.short_v_item_v_o[].id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.short_v_items[].title | String | 未标注 | 展示标题 | 宝贝标题 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.short_v_items.short_v_item_v_o[].title |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].material.short_v_items[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/x/x/x.jpg | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].material.short_v_items.short_v_item_v_o[].url |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].alive_group_id | Number | 未标注 | 业务对象标识；枚举：0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].alive_group_id |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].alive_group_name | String | 未标注 | 业务字段 alive_group_name | 宝贝链接(默认) | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].alive_group_name |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].black_creative_status | String | 未标注 | 业务字段 black_creative_status；枚举：success=合成成功、fail=合成失败 | success | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].black_creative_status |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].gmt_create | Date | 未标注 | 业务字段 gmt_create | 2023-12-09 14:34:12 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].gmt_create |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].gmt_modified | Date | 未标注 | 业务字段 gmt_modified | 2023-12-09 14:34:12 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].gmt_modified |
| top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list[].smart_creative | Number | 未标注 | 业务字段 smart_creative；枚举：0=关闭、1=开启 | 1 | universalbp_new_adgroup_horizontal_findpage_response.top_result.adgroup_v_o_top_bulk_data.adgroup_v_o_list.adgroup_v_o[].smart_creative |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.adgroup.horizontal.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adgroup_query_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.horizontal.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"adgroup_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：3c8cc8e139fdd76977e5a50111581ba27cb408bb167d22fecf3abece941f1632



---

# 批量更新单元或主体出价

`taobao.universalbp.new.adgroup.bid.batchupdate`

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

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

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

## 请求业务字段

路径均位于本站 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_bid_command_list_v_o | AdgroupBidCommandListVO | 是 | 单元出价操作列表 | — |
| adgroup_bid_command_list_v_o.bid_list | AdgroupBidCommandVO [] | 是 | 出价列表 | — |
| adgroup_bid_command_list_v_o.bid_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| adgroup_bid_command_list_v_o.bid_list[].enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| adgroup_bid_command_list_v_o.bid_list[].ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| adgroup_bid_command_list_v_o.bid_list[].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=提高成交量 | conv |
| adgroup_bid_command_list_v_o.bid_list[].enable_cold_speed_new_item | Boolean | 否 | 业务字段 enable_cold_speed_new_item；枚举：true=是、false=否 | true |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adgroup_bid_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adgroup_bid_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adgroup_bid_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adgroup_bid_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adgroup_bid_batchupdate_response.top_result.info.error_code |
| top_result.adgroup_bid_update_result_v_o_top_part_data | TopPartData | 未标注 | 单元出价结果对象 | — | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data |
| top_result.adgroup_bid_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.count |
| top_result.adgroup_bid_update_result_v_o_top_part_data.adgroup_bid_update_result_v_o_list | AdgroupBidUpdateResultVO [] | 未标注 | 单元出价结果列表集合 | — | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.adgroup_bid_update_result_v_o_list |
| top_result.adgroup_bid_update_result_v_o_top_part_data.adgroup_bid_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.adgroup_bid_update_result_v_o_list.adgroup_bid_update_result_v_o[].adgroup_id |
| top_result.adgroup_bid_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.error_count |
| top_result.adgroup_bid_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.error_details |
| top_result.adgroup_bid_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.adgroup_bid_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.adgroup.bid.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adgroup_bid_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.adgroup_bid_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_adgroup_bid_batchupdate_response.top_result.adgroup_bid_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：3f41a37ce9a3b468b5335197bf85a5741bb901675fe9f0379ddda57bb84a040a



---

# 批量添加单元或主体

`taobao.universalbp.new.adgroup.addlist`

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

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

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

## 请求业务字段

路径均位于本站 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



---

# 获取账户余额，现金余额

`taobao.universalbp.new.account.get.balance`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_account_get_balance_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_account_get_balance_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_account_get_balance_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_account_get_balance_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_account_get_balance_response.top_result.info.error_code |
| top_result.top_account_balance_v_o | TopAccountBalanceVO | 未标注 | 账户余额 | — | universalbp_new_account_get_balance_response.top_result.top_account_balance_v_o |
| top_result.top_account_balance_v_o.rt_cash_balance | String | 未标注 | 业务字段 rt_cash_balance | 999.99 | universalbp_new_account_get_balance_response.top_result.top_account_balance_v_o.rt_cash_balance |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.account.get.balance",
  "params": {
    "top_service_context": {
      "biz_code": "onebpSite",
      "login_type": 1,
      "ext": "{}"
    }
  }
}

```

## 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.account.get.balance\",\"params\":{\"top_service_context\":{\"biz_code\":\"onebpSite\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：ef79899a11e566b541624971fefc5f75efc317d173e3c9104e9826030de91d6a



---

# 获取账户可用的bizCode

`taobao.universalbp.new.account.get.can.use.bizcode`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_account_get_can_use_bizcode_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_account_get_can_use_bizcode_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_account_get_can_use_bizcode_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_account_get_can_use_bizcode_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_account_get_can_use_bizcode_response.top_result.info.error_code |
| top_result.top_market_scene_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data |
| top_result.top_market_scene_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data.count |
| top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list | TopMarketSceneVO [] | 未标注 | 列表集合 | — | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list |
| top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list.top_market_scene_v_o[].biz_code |
| top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list[].app_id | Number | 未标注 | 业务对象标识 | 372 | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list.top_market_scene_v_o[].app_id |
| top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list[].market_name | String | 未标注 | 业务字段 market_name | 精准人群推广 | universalbp_new_account_get_can_use_bizcode_response.top_result.top_market_scene_v_o_top_bulk_data.top_market_scene_v_o_list.top_market_scene_v_o[].market_name |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.account.get.can.use.bizcode",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    }
  }
}

```

## 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.account.get.can.use.bizcode\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：acf7a15d0a6f65da9f0285bd024a70ac4eee335b46a7ccc22398f2fe2090da81



---

# 关键词建议出价

`taobao.universalbp.new.suggest.bidword.price`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bidword_single_query_v_o | BidwordSingleQueryVO | 是 | 关键词查询对象 | — |
| bidword_single_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68764632161 |
| bidword_single_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68805630167 |
| bidword_single_query_v_o.bidword_id | Number | 否 | 关键词标识 | 1131759830446 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_suggest_bidword_price_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_suggest_bidword_price_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_suggest_bidword_price_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_suggest_bidword_price_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_suggest_bidword_price_response.top_result.info.error_code |
| top_result.bidword_price_suggest_v_o | BidwordPriceSuggestVO | 未标注 | 关键词金额建议 | — | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o |
| top_result.bidword_price_suggest_v_o.campaign_id | Number | 未标注 | 推广计划编号 | 68764632161 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.campaign_id |
| top_result.bidword_price_suggest_v_o.adgroup_id | Number | 未标注 | 推广单元编号 | 68805630167 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.adgroup_id |
| top_result.bidword_price_suggest_v_o.bidword_id | Number | 未标注 | 关键词标识 | 1131759830446 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bidword_id |
| top_result.bidword_price_suggest_v_o.no_impression_reason | Number | 未标注 | 业务字段 no_impression_reason | 0 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.no_impression_reason |
| top_result.bidword_price_suggest_v_o.suggest_list | BidwordPriceSuggestItemVO [] | 未标注 | 建议列表 | — | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list |
| top_result.bidword_price_suggest_v_o.suggest_list[].bid_price | String | 未标注 | 出价金额 | 0.78 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].bid_price |
| top_result.bidword_price_suggest_v_o.suggest_list[].rank | Number | 未标注 | 业务字段 rank | 35 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].rank |
| top_result.bidword_price_suggest_v_o.suggest_list[].rank_name | String | 未标注 | 业务字段 rank_name | 31~35位 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].rank_name |
| top_result.bidword_price_suggest_v_o.suggest_list[].type | Number | 未标注 | 类型；枚举：0=出价建议、4=抢位建议、5=当前出价 | 0 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].type |
| top_result.bidword_price_suggest_v_o.suggest_list[].discount | Number | 未标注 | 出价溢价 | 30 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].discount |
| top_result.bidword_price_suggest_v_o.suggest_list[].market_share_info | String | 未标注 | 业务字段 market_share_info | xxxxx | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].market_share_info |
| top_result.bidword_price_suggest_v_o.suggest_list[].reason | String | 未标注 | 业务字段 reason | xxxxx | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_list.bidword_price_suggest_item_v_o[].reason |
| top_result.bidword_price_suggest_v_o.bid_strategy_info | BidStrategyVO | 未标注 | 出价对象 | — | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bid_strategy_info |
| top_result.bidword_price_suggest_v_o.bid_strategy_info.discount | Number | 未标注 | 出价溢价 | 30 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bid_strategy_info.discount |
| top_result.bidword_price_suggest_v_o.bid_strategy_info.status | Number | 未标注 | 状态标识 | 0 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bid_strategy_info.status |
| top_result.bidword_price_suggest_v_o.bid_strategy_info.rank | Number | 未标注 | 业务字段 rank | 1 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bid_strategy_info.rank |
| top_result.bidword_price_suggest_v_o.bid_strategy_info.rank_name | String | 未标注 | 业务字段 rank_name | 首条 | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.bid_strategy_info.rank_name |
| top_result.bidword_price_suggest_v_o.suggest_trace_id | String | 未标注 | 建议标识 | xxxxx | universalbp_new_suggest_bidword_price_response.top_result.bidword_price_suggest_v_o.suggest_trace_id |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.suggest.bidword.price",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bidword_single_query_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.suggest.bidword.price\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bidword_single_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：7bb93c6be13f2d9b645587c1ef57db57171199012c9fc84cdfdb417479a12d13



---

# 批量修改关键词

`taobao.universalbp.new.bidword.update`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_update_request_v_o | WordUpdateRequestVO | 是 | 词对象 | — |
| word_update_request_v_o.bidword_list | WordCommandVO [] | 否 | 关键词列表 | — |
| word_update_request_v_o.bidword_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| word_update_request_v_o.bidword_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| word_update_request_v_o.bidword_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| word_update_request_v_o.bidword_list[].word | String | 否 | 词 | 鞋原创小众 |
| word_update_request_v_o.bidword_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| word_update_request_v_o.bidword_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| word_update_request_v_o.bidword_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| word_update_request_v_o.bidword_list[].bid_strategy_info | BidStrategyVO | 否 | 出价对象 | — |
| word_update_request_v_o.bidword_list[].bid_strategy_info.discount | Number | 否 | 出价溢价 | 30 |
| word_update_request_v_o.bidword_list[].bid_strategy_info.status | Number | 否 | 状态标识 | 0 |
| word_update_request_v_o.bidword_list[].bid_strategy_info.rank | Number | 否 | 业务字段 rank | 1 |
| word_update_request_v_o.bidword_list[].bid_strategy_info.rank_name | String | 否 | 业务字段 rank_name | 首条 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_update_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_update_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_update_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_update_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_update_response.top_result.info.error_code |
| top_result.word_command_v_o_top_bulk_data | TopBulkData | 未标注 | 词操作对象 | — | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data |
| top_result.word_command_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.count |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list | WordCommandVO [] | 未标注 | 词操作列表 | — | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].bidword_id | Number | 未标注 | 关键词标识；关键词已经存在场景必填 | 1124844766581 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].bidword_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].campaign_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号；单元已经存在场景必填 | 68793666608 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].adgroup_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].word | String | 未标注 | 词 | 鞋原创小众 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].word |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].bid_price |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].online_status |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].match_scope | Number | 未标注 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 | universalbp_new_bidword_update_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].match_scope |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.update",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_update_request_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.bidword.update\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_update_request_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 表示业务未完成。

来源校验 SHA256：ee00c975d6e4f79147e949ba0b21e142d41d11002b5f85d7a49db0ed90a0dce0



---

# 关键词建议

`taobao.universalbp.new.bidword.suggestkrlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bidword_suggest_query_v_o | BidwordSuggestQueryVO | 是 | 关键词建议查询 | — |
| bidword_suggest_query_v_o.type | String | 否 | 类型；枚举：kr_overall=综合推荐、kr_flow=精准引流、kr_category=类目优质词、kr_industry=行业机会词、kr_mta=助攻词、kr_search=搜索词联想、kr_byword=以词推词、kr_bycrowd=以人群词、new_default=新建流程默认推词 | kr_overall |
| bidword_suggest_query_v_o.material_id | Number | 否 | 素材标识 | 715017855321 |
| bidword_suggest_query_v_o.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| bidword_suggest_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| bidword_suggest_query_v_o.word | String | 否 | 词 | 连衣裙 |
| bidword_suggest_query_v_o.crowd_id_list | Number [] | 否 | 人群标识列表 | [111] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_suggestkrlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_suggestkrlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_suggestkrlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_suggestkrlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_suggestkrlist_response.top_result.info.error_code |
| top_result.suggest_bidword_v_o_top_bulk_data | TopBulkData | 未标注 | 建议关键词对象 | — | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data |
| top_result.suggest_bidword_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.count |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list | SuggestBidwordVO [] | 未标注 | 建议关键词列表 | — | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].word | String | 未标注 | 词 | 吵吵家 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].word |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].bid_price | String | 未标注 | 出价金额 | 1 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].bid_price |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].avg_price | String | 未标注 | 业务字段 avg_price | 0.47 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].avg_price |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].impression | String | 未标注 | 业务字段 impression | 0-10 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].impression |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].relevance_type | Number | 未标注 | 业务字段 relevance_type；枚举：1=差、2=中、3=好 | 3 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].relevance_type |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].ctr | String | 未标注 | 点击比例 | 0.0381 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].ctr |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].cvr | String | 未标注 | 转化比例 | 0.0209 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].cvr |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].impression_index | Number | 未标注 | 业务字段 impression_index | 30 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].impression_index |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].competition_index | String | 未标注 | 业务字段 competition_index | 20 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].competition_index |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].search_index | Number | 未标注 | 业务字段 search_index | 20 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].search_index |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].qscore | String | 未标注 | 业务字段 qscore | 6.00 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].qscore |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].item_click | Number | 未标注 | 业务字段 item_click | 20 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].item_click |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].transaction_shipping_total | Number | 未标注 | 业务字段 transaction_shipping_total | 20 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].transaction_shipping_total |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].item_click_coverage | String | 未标注 | 业务字段 item_click_coverage | 0.5 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].item_click_coverage |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].code |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].name |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].tips |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].icon |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].color |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].type |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].reason_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].type | Number | 未标注 | 类型；枚举：0=宝贝、1=店铺 | 0 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].type |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].mta_roi | String | 未标注 | 业务字段 mta_roi | 20 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].mta_roi |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].predict_click | String | 未标注 | 业务字段 predict_click | 0.029 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].predict_click |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].market_click_rate | String | 未标注 | 业务字段 market_click_rate | 0.029 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].market_click_rate |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].market_average_bid | String | 未标注 | 业务字段 market_average_bid | 0.029 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].market_average_bid |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].market_click_conversion_rate | String | 未标注 | 业务字段 market_click_conversion_rate | 0.29 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].market_click_conversion_rate |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].first_slot_impression_rate | String | 未标注 | 业务字段 first_slot_impression_rate | 0.29 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].first_slot_impression_rate |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].lead_ad_gmv_rate | String | 未标注 | 业务字段 lead_ad_gmv_rate | 0.046 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].lead_ad_gmv_rate |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].trend_index | String | 未标注 | 业务字段 trend_index | 0.046 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].trend_index |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].present_m_penetration_rate | String | 未标注 | 业务字段 present_m_penetration_rate | 0.46 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].present_m_penetration_rate |
| top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list[].rec_reason | String | 未标注 | 业务字段 rec_reason | 热门词 | universalbp_new_bidword_suggestkrlist_response.top_result.suggest_bidword_v_o_top_bulk_data.suggest_bidword_v_o_list.suggest_bidword_v_o[].rec_reason |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.suggestkrlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bidword_suggest_query_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.bidword.suggestkrlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bidword_suggest_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：3f10c5baf1b479fb9690736d9123621ddd0269900d3ad116f011606aa71ef049



---

# 建议默认关键词

`taobao.universalbp.new.bidword.suggestdefaultlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bidword_default_query_v_o | BidwordDefaultQueryVO | 是 | 关键词查询对象 | — |
| bidword_default_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_suggestdefaultlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_suggestdefaultlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_suggestdefaultlist_response.top_result.info.error_code |
| top_result.bidword_suggest_item_v_o_top_bulk_data | TopBulkData | 未标注 | 关键词建议商品对象 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data |
| top_result.bidword_suggest_item_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.count |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list | BidwordSuggestItemVO [] | 未标注 | 关键词建议商品列表 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].material_id | Number | 未标注 | 素材标识 | 715017855321 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].material_id |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list | SuggestBidwordVO [] | 未标注 | 词列表 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].word | String | 未标注 | 词 | 吵吵家 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].word |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].bid_price | String | 未标注 | 出价金额 | 1 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].bid_price |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].avg_price | String | 未标注 | 业务字段 avg_price | 0.47 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].avg_price |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].impression | String | 未标注 | 业务字段 impression | 0-10 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].impression |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].relevance_type | Number | 未标注 | 业务字段 relevance_type；枚举：1=差、2=中、3=好 | 3 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].relevance_type |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].ctr | String | 未标注 | 点击比例 | 0.0381 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].ctr |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].cvr | String | 未标注 | 转化比例 | 0.0209 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].cvr |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].impression_index | Number | 未标注 | 业务字段 impression_index | 30 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].impression_index |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].competition_index | String | 未标注 | 业务字段 competition_index | 20 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].competition_index |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].search_index | Number | 未标注 | 业务字段 search_index | 20 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].search_index |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].qscore | String | 未标注 | 业务字段 qscore | 6.00 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].qscore |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].item_click | Number | 未标注 | 业务字段 item_click | 20 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].item_click |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].transaction_shipping_total | Number | 未标注 | 业务字段 transaction_shipping_total | 20 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].transaction_shipping_total |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].item_click_coverage | String | 未标注 | 业务字段 item_click_coverage | 0.5 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].item_click_coverage |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].code |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].name |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].tips |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].icon |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].color |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].reason_tag_list.show_tag_v_o[].type |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].reason_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].type | Number | 未标注 | 类型；枚举：0=宝贝、1=店铺 | 0 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].type |
| top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list[].word_list[].mta_roi | String | 未标注 | 业务字段 mta_roi | 20 | universalbp_new_bidword_suggestdefaultlist_response.top_result.bidword_suggest_item_v_o_top_bulk_data.bidword_suggest_item_v_o_list.bidword_suggest_item_v_o[].word_list.suggest_bidword_v_o[].mta_roi |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.suggestdefaultlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bidword_default_query_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.bidword.suggestdefaultlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bidword_default_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：d4d10ea7a528bc83c74e0e3430407c9e4574ebcc9e1539110c40f2fbf05f5a72



---

# 实时质量分查询

`taobao.universalbp.new.bidword.qscore`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| qscore_real_query_v_o | QscoreRealQueryVO | 是 | 查询对象 | — |
| qscore_real_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| qscore_real_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| qscore_real_query_v_o.bidword_id_list | Number [] | 否 | 关键词标识列表 | [1129786056742] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_qscore_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_qscore_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_qscore_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_qscore_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_qscore_response.top_result.info.error_code |
| top_result.qscore_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data |
| top_result.qscore_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.count |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list | QscoreVO [] | 未标注 | 列表集合 | — | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].campaign_id |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].adgroup_id |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].bidword_id | Number | 未标注 | 关键词标识 | 1129786056742 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].bidword_id |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].word | String | 未标注 | 词 | 词 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].word |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].qscore | String | 未标注 | 业务字段 qscore | 6.00 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].qscore |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].creative_score | String | 未标注 | 业务字段 creative_score | 6.00 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].creative_score |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].cust_score | String | 未标注 | 业务字段 cust_score | 6.00 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].cust_score |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].category_match | Boolean | 未标注 | 业务字段 category_match | true | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].category_match |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].brand_match | Boolean | 未标注 | 业务字段 brand_match | true | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].brand_match |
| top_result.qscore_v_o_top_bulk_data.qscore_v_o_list[].thedate | Date | 未标注 | 数据所属日期 | 2023-09-10 | universalbp_new_bidword_qscore_response.top_result.qscore_v_o_top_bulk_data.qscore_v_o_list.qscore_v_o[].thedate |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.qscore",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "qscore_real_query_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.bidword.qscore\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"qscore_real_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：593ac20e07b126ef9eb36f736f58bd1a8894fab78146e2ba176f1a7b1852099c



---

# 词列表查询

`taobao.universalbp.new.bidword.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_query_v_o | WordQueryVO | 是 | 词查询 | — |
| word_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| word_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [68798447504] |
| word_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| word_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| word_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| word_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间；如需查询报表必填 | 2025-10-08 |
| word_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间；如需查询报表必填 | 2025-10-08 |
| word_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| word_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| word_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| word_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_findlist_response.top_result.info.error_code |
| top_result.word_v_o_top_bulk_data | TopBulkData | 未标注 | 词对象 | — | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data |
| top_result.word_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.count |
| top_result.word_v_o_top_bulk_data.word_v_o_list | WordVO [] | 未标注 | 词列表 | — | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bidword_id | Number | 未标注 | 关键词标识 | 1131759830446 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bidword_id |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].campaign_id |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].adgroup_id |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].word | String | 未标注 | 词 | 鞋原创小众 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].word |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_price |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].status | String | 未标注 | 状态标识；枚举：reject=排查拒绝、preview=排查中、launch=投放中、noflow=无展现 | launch | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].status |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].match_scope | Number | 未标注 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].match_scope |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_strategy_info | BidStrategyVO | 未标注 | 出价对象 | — | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_strategy_info |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_strategy_info.discount | Number | 未标注 | 出价溢价 | 30 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_strategy_info.discount |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_strategy_info.status | Number | 未标注 | 状态标识 | 0 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_strategy_info.status |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_strategy_info.rank | Number | 未标注 | 业务字段 rank | 1 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_strategy_info.rank |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].bid_strategy_info.rank_name | String | 未标注 | 业务字段 rank_name | 首条 | universalbp_new_bidword_findlist_response.top_result.word_v_o_top_bulk_data.word_v_o_list.word_v_o[].bid_strategy_info.rank_name |
| top_result.word_v_o_top_bulk_data.word_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_query_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.bidword.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：9b123289fd4070daa87c0b794f3f8453eb945c01bb1e7e6675b17c6e20cae21c



---

# 批量删除关键词

`taobao.universalbp.new.bidword.delete`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bid_word_delete_v_o | BidWordDeleteVO | 是 | 出价词对象 | — |
| bid_word_delete_v_o.bidword_id_list | Number [] | 是 | 关键词标识列表 | [1129786056742] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_delete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_delete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_delete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_delete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_delete_response.top_result.info.error_code |
| top_result.top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_bidword_delete_response.top_result.top_bulk_data |
| top_result.top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_delete_response.top_result.top_bulk_data.count |
| top_result.top_bulk_data.data_list | String [] | 未标注 | 业务条件集合 | 10,20 | universalbp_new_bidword_delete_response.top_result.top_bulk_data.data_list |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.delete",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bid_word_delete_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.bidword.delete\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bid_word_delete_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 表示业务未完成。

来源校验 SHA256：60b89f1d079ae453b7781ce1363c10794d979197af1fc2e5546769259d4cb3be



---

# 批量添加关键词

`taobao.universalbp.new.bidword.add`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bid_word_add_request_v_o | BidWordAddRequestVO | 是 | 出价词对象 | — |
| bid_word_add_request_v_o.bidword_list | WordCommandVO [] | 否 | 关键词列表 | — |
| bid_word_add_request_v_o.bidword_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| bid_word_add_request_v_o.bidword_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| bid_word_add_request_v_o.bidword_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| bid_word_add_request_v_o.bidword_list[].word | String | 否 | 词 | 鞋原创小众 |
| bid_word_add_request_v_o.bidword_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| bid_word_add_request_v_o.bidword_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| bid_word_add_request_v_o.bidword_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_bidword_add_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_bidword_add_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_bidword_add_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_bidword_add_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_bidword_add_response.top_result.info.error_code |
| top_result.word_command_v_o_top_bulk_data | TopBulkData | 未标注 | 词操作对象 | — | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data |
| top_result.word_command_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.count |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list | WordCommandVO [] | 未标注 | 词操作列表 | — | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].bidword_id | Number | 未标注 | 关键词标识；关键词已经存在场景必填 | 1124844766581 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].bidword_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].campaign_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号；单元已经存在场景必填 | 68793666608 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].adgroup_id |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].word | String | 未标注 | 词 | 鞋原创小众 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].word |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].bid_price |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].online_status |
| top_result.word_command_v_o_top_bulk_data.word_command_v_o_list[].match_scope | Number | 未标注 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 | universalbp_new_bidword_add_response.top_result.word_command_v_o_top_bulk_data.word_command_v_o_list.word_command_v_o[].match_scope |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.bidword.add",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bid_word_add_request_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.bidword.add\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bid_word_add_request_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 表示业务未完成。

来源校验 SHA256：8460fa80b7925ba5369e13db18d0ff83df9f7a4f6b4dbe5f082161ddab6a37b8



---

# 定向标签列表(分页)

`taobao.universalbp.new.label.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| label_query_v_o | LabelQueryVO | 是 | 定向标签查询 | — |
| label_query_v_o.label_list | LabelEntryQueryVO [] | 否 | 定向标签列表 | — |
| label_query_v_o.label_list[].label_id | String | 否 | 定向标签标识 | 3000494 |
| label_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| label_query_v_o.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 |
| label_query_v_o.category | CategoryQueryVO | 否 | 业务对象 | — |
| label_query_v_o.category.cat_id | Number | 否 | 业务对象标识 | 35 |
| label_query_v_o.category.cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| label_query_v_o.category.cat_level | Number | 否 | 业务字段 cat_level | 1 |
| label_query_v_o.search_category | CategoryQueryVO | 否 | 业务对象 | — |
| label_query_v_o.search_category.cat_id | Number | 否 | 业务对象标识 | 35 |
| label_query_v_o.search_category.cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| label_query_v_o.search_category.cat_level | Number | 否 | 业务字段 cat_level | 1 |
| label_query_v_o.rec_query_time | Number | 否 | 业务字段 rec_query_time | 30 |
| label_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |
| label_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68795552573 |
| label_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| label_query_v_o.option_name | String | 否 | 业务字段 option_name | 书包 |
| label_query_v_o.offset | Number | 否 | 结果起始偏移 | 0 |
| label_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| label_query_v_o.comp_item_type_list | String [] | 否 | 商品类型集合；枚举：sim=相似宝贝、spu=同款宝贝、rel=搭配宝贝 | ["sim"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_findpage_response.top_result.info.error_code |
| top_result.label_v_o_top_bulk_data | TopBulkData | 未标注 | 定向标签对象 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data |
| top_result.label_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.count |
| top_result.label_v_o_top_bulk_data.label_v_o_list | LabelVO [] | 未标注 | 定向标签列表 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].target_type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price_dimension |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.average_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.min_fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.max_fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.validate_bid_min |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.validate_bid_max |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.peer_avg_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].is_multi |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findpage_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_id |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.label.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "label_query_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.label.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"label_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：0061ed5bc590c46a5e5c4f29c4d03bfae180de1e4efc13928126342357c6236d



---

# 定向标签列表(全量)

`taobao.universalbp.new.label.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| label_query_v_o | LabelQueryVO | 是 | 定向标签查询 | — |
| label_query_v_o.label_list | LabelEntryQueryVO [] | 否 | 定向标签列表 | — |
| label_query_v_o.label_list[].label_id | String | 否 | 定向标签标识 | 3000494 |
| label_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| label_query_v_o.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 |
| label_query_v_o.category | CategoryQueryVO | 否 | 业务对象 | — |
| label_query_v_o.category.cat_id | Number | 否 | 业务对象标识 | 35 |
| label_query_v_o.category.cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| label_query_v_o.category.cat_level | Number | 否 | 业务字段 cat_level | 1 |
| label_query_v_o.search_category | CategoryQueryVO | 否 | 业务对象 | — |
| label_query_v_o.search_category.cat_id | Number | 否 | 业务对象标识 | 35 |
| label_query_v_o.search_category.cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| label_query_v_o.search_category.cat_level | Number | 否 | 业务字段 cat_level | 1 |
| label_query_v_o.rec_query_time | Number | 否 | 业务字段 rec_query_time | 30 |
| label_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |
| label_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68795552573 |
| label_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| label_query_v_o.option_name | String | 否 | 业务字段 option_name | 书包 |
| label_query_v_o.offset | Number | 否 | 结果起始偏移 | 0 |
| label_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| label_query_v_o.comp_item_type_list | String [] | 否 | 商品类型集合；枚举：sim=相似宝贝、spu=同款宝贝、rel=搭配宝贝 | ["sim"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_findlist_response.top_result.info.error_code |
| top_result.label_v_o_top_bulk_data | TopBulkData | 未标注 | 定向标签对象 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data |
| top_result.label_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.count |
| top_result.label_v_o_top_bulk_data.label_v_o_list | LabelVO [] | 未标注 | 定向标签列表 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].target_type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price_dimension |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.average_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.min_fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.max_fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.validate_bid_min |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.validate_bid_max |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.peer_avg_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].is_multi |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_findlist_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_id |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.label.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "label_query_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.label.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"label_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：0a43012cfdf7fa614e5bf60845b96f52294475fa25543c2bdb9eff9d404559e2



---

# DMP定向转换

`taobao.universalbp.new.label.dmpconvert`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| dmp_label_convert_list_v_o | DmpLabelConvertListVO | 是 | 定向标签列表对象 | — |
| dmp_label_convert_list_v_o.crowd_list | DmpLabelConvertQueryVO [] | 是 | 人群列表 | — |
| dmp_label_convert_list_v_o.crowd_list[].label_list | LabelEntryQueryVO [] | 否 | 定向标签列表 | — |
| dmp_label_convert_list_v_o.crowd_list[].label_list[].label_id | String | 否 | 定向标签标识 | 3000494 |
| dmp_label_convert_list_v_o.crowd_list[].option_list | OptionQueryVO [] | 否 | 列表集合 | — |
| dmp_label_convert_list_v_o.crowd_list[].option_list[].option_name | String | 否 | 业务字段 option_name | 自定义人群0608200328 |
| dmp_label_convert_list_v_o.crowd_list[].option_list[].option_value | String | 否 | 业务字段 option_value | 24431233 |
| dmp_label_convert_list_v_o.crowd_list[].option_list[].topic_id | Number | 否 | 业务对象标识 | 112 |
| dmp_label_convert_list_v_o.crowd_list[].option_list[].template_id | Number | 否 | 模板标识 | 77480 |
| dmp_label_convert_list_v_o.crowd_list[].option_list[].uuid_mark | String | 否 | 业务字段 uuid_mark | 99e5934edd6c4a54a52c1e7356ebecba |
| dmp_label_convert_list_v_o.crowd_list[].target_value | String | 否 | 目标值 | 24431233 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_dmpconvert_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_dmpconvert_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_dmpconvert_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_dmpconvert_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_dmpconvert_response.top_result.info.error_code |
| top_result.label_v_o_top_bulk_data | TopBulkData | 未标注 | 定向标签对象 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data |
| top_result.label_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.count |
| top_result.label_v_o_top_bulk_data.label_v_o_list | LabelVO [] | 未标注 | 定向标签列表 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].target_type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price_dimension |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 30 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 30 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_bid_price |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].price.fit_discount |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_value |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_desc |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].tag_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].option_group_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].is_multi |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].category_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.dmp_option_group_id |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_name |
| top_result.label_v_o_top_bulk_data.label_v_o_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_label_dmpconvert_response.top_result.label_v_o_top_bulk_data.label_v_o_list.label_v_o[].label_option_properties.cate_id |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：9ccb39f195e4c3657e8bb5372de905aac2977348c212d57870bfe993f8a404e2



---

# 判断用户是否迁移新bp

`taobao.universalbp.new.account.is.universal.user`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | — |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | — |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | — |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | — |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | — |
| top_result.top_account_status_v_o | TopAccountStatusVO | 未标注 | 账户状态 | — | — |
| top_result.top_account_status_v_o.is_universal_bp_user | Boolean | 未标注 | 业务字段 is_universal_bp_user | true, false | — |

## 核对备注

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

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.account.is.universal.user",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    }
  }
}

```

## 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.account.is.universal.user\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：16a96a32844c944c3294859a5a500907401a483aef1c9d9da04dedf98e339493



---

# 关键词包建议

`taobao.universalbp.new.wordpackage.suggestkrlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_suggest_query_v_o | WordPackageSuggestQueryVO | 是 | 词建议查询对象 | — |
| word_package_suggest_query_v_o.material_id | Number | 否 | 素材标识 | 715017855321 |
| word_package_suggest_query_v_o.type | String | 否 | 类型；枚举：overall=综合推荐、trendtheme=趋势词包、automatch=流量智选、extend=流量扩展、highquality=优质卖点词包推荐(用于卖点词包报告)、new_default=新建流程默认推荐词包 | trendTheme |
| word_package_suggest_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68792485515 |
| word_package_suggest_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68792986520 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_suggestkrlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_suggestkrlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_suggestkrlist_response.top_result.info.error_code |
| top_result.suggest_word_package_v_o_top_bulk_data | TopBulkData | 未标注 | 建议词对象 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data |
| top_result.suggest_word_package_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.count |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list | SuggestWordPackageVO [] | 未标注 | 建议词列表集合 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].word_package_id | Number | 未标注 | 词标识 | 191014 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].word_package_id |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、20=卖点词包 | 20 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].word_package_type |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].word_package_name | String | 未标注 | 业务字段 word_package_name | 碎花 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].word_package_name |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].online_status |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].bid_price | String | 未标注 | 出价金额 | 1 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].bid_price |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].impression | String | 未标注 | 业务字段 impression | 10-20 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].impression |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].multi_factor | String | 未标注 | 业务字段 multi_factor | 10.0 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].multi_factor |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].theme_word_list | String [] | 未标注 | 词集合 | ["碎花"] | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].theme_word_list |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].simple_word_list | String [] | 未标注 | 词集合 | ["碎花裙", "碎花连衣裙", "碎花连衣裙女", "法式碎花裙"] | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].simple_word_list |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].relevance_type | Number | 未标注 | 业务字段 relevance_type；枚举：1=差、2=中、3=好 | 3 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].relevance_type |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list | WordPackageStrategyVO [] | 未标注 | 列表集合 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].strategy_id | Number | 未标注 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_id |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].strategy_name | String | 未标注 | 业务字段 strategy_name | 好词优选 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_name |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].word_package_type |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].bid_price |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].online_status |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].adgroup_id |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].campaign_id |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].strategy_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].code |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].name |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].tips |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].icon |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].color |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_wordpackage_suggestkrlist_response.top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].type |
| top_result.suggest_word_package_v_o_top_bulk_data.suggest_word_package_v_o_list[].reason_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.wordpackage.suggestkrlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_package_suggest_query_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.wordpackage.suggestkrlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_package_suggest_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：a58b1744aa16b0cdf599dcf14c5a741adcad0e47e1003739743a2b7601f68ee0



---

# 批量更新词包

`taobao.universalbp.new.wordpackage.update`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_update_request_v_o | WordPackageUpdateRequestVO | 是 | 词对象 | — |
| word_package_update_request_v_o.word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| word_package_update_request_v_o.word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| word_package_update_request_v_o.word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| word_package_update_request_v_o.word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| word_package_update_request_v_o.word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| word_package_update_request_v_o.word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| word_package_update_request_v_o.word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| word_package_update_request_v_o.word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| word_package_update_request_v_o.word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| word_package_update_request_v_o.word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| word_package_update_request_v_o.word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| word_package_update_request_v_o.word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_update_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_update_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_update_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_update_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_update_response.top_result.info.error_code |
| top_result.top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_wordpackage_update_response.top_result.top_bulk_data |
| top_result.top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_update_response.top_result.top_bulk_data.count |
| top_result.top_bulk_data.data_list | String [] | 未标注 | 业务条件集合 | 10,20 | universalbp_new_wordpackage_update_response.top_result.top_bulk_data.data_list |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.wordpackage.update",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_package_update_request_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.wordpackage.update\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_package_update_request_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 表示业务未完成。

来源校验 SHA256：73877f6faece151e8bae215a59c06aca36c12fe0a0ec25c54292cb631977f8c7



---

# 建议默认关键词包

`taobao.universalbp.new.wordpackage.suggestdefaultlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_default_query_v_o | WordPackageDefaultQueryVO | 是 | 词查询对象 | — |
| word_package_default_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.info.error_code |
| top_result.word_package_suggest_item_v_o_top_bulk_data | TopBulkData | 未标注 | 词建议商品对象 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data |
| top_result.word_package_suggest_item_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.count |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list | WordPackageSuggestItemVO [] | 未标注 | 词建议商品列表集合 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].material_id | Number | 未标注 | 素材标识 | 715017855321 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].material_id |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list | SuggestWordPackageVO [] | 未标注 | 词列表集合 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].word_package_id | Number | 未标注 | 词标识 | 191014 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].word_package_id |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、20=卖点词包 | 20 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].word_package_type |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].word_package_name | String | 未标注 | 业务字段 word_package_name | 碎花 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].word_package_name |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].online_status |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].bid_price | String | 未标注 | 出价金额 | 1 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].bid_price |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].impression | String | 未标注 | 业务字段 impression | 10-20 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].impression |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].multi_factor | String | 未标注 | 业务字段 multi_factor | 10.0 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].multi_factor |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].theme_word_list | String [] | 未标注 | 词集合 | ["碎花"] | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].theme_word_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].simple_word_list | String [] | 未标注 | 词集合 | ["碎花裙", "碎花连衣裙", "碎花连衣裙女", "法式碎花裙"] | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].simple_word_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].relevance_type | Number | 未标注 | 业务字段 relevance_type；枚举：1=差、2=中、3=好 | 3 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].relevance_type |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list | WordPackageStrategyVO [] | 未标注 | 列表集合 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].strategy_id | Number | 未标注 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_id |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].strategy_name | String | 未标注 | 业务字段 strategy_name | 好词优选 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_name |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].word_package_type |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].bid_price |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].online_status |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].adgroup_id |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].strategy_list.word_package_strategy_v_o[].campaign_id |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].strategy_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].code |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].name |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].tips |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].icon |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].color |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_wordpackage_suggestdefaultlist_response.top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list.word_package_suggest_item_v_o[].word_package_list.suggest_word_package_v_o[].reason_tag_list.show_tag_v_o[].type |
| top_result.word_package_suggest_item_v_o_top_bulk_data.word_package_suggest_item_v_o_list[].word_package_list[].reason_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.wordpackage.suggestdefaultlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_package_default_query_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.wordpackage.suggestdefaultlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_package_default_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：59f3d55a8a287461021b587ac4af4ea1960798d500c9637cc13ae7037af4413d



---

# 词包列表查询

`taobao.universalbp.new.wordpackage.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_query_v_o | WordPackageQueryVO | 是 | 词查询对象 | — |
| word_package_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表；计划已经存在场景必填 | [68792788657] |
| word_package_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表；单元已经存在场景必填 | [68798447504] |
| word_package_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| word_package_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| word_package_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| word_package_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| word_package_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| word_package_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| word_package_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| word_package_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| word_package_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_findlist_response.top_result.info.error_code |
| top_result.word_package_v_o_top_bulk_data | TopBulkData | 未标注 | 词对象 | — | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data |
| top_result.word_package_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.count |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list | WordPackageVO [] | 未标注 | 词列表集合 | — | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].campaign_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].adgroup_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].word_package_id | Number | 未标注 | 词标识 | 38577 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].word_package_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].word_package_name | String | 未标注 | 业务字段 word_package_name | 流量智选 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].word_package_name |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].word_package_type |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].status | Number | 未标注 | 状态标识；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].status |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].bid_price | String | 未标注 | 出价金额 | 5 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].bid_price |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list | WordPackageStrategyVO [] | 未标注 | 列表集合 | — | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].strategy_id | Number | 未标注 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].strategy_name | String | 未标注 | 业务字段 strategy_name | 好词优选 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].strategy_name |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].word_package_type | Number | 未标注 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].word_package_type |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].bid_price | String | 未标注 | 出价金额 | 2.23 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].bid_price |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=在线、0=下线 | 1 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].online_status |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].adgroup_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_wordpackage_findlist_response.top_result.word_package_v_o_top_bulk_data.word_package_v_o_list.word_package_v_o[].strategy_list.word_package_strategy_v_o[].campaign_id |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].strategy_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.word_package_v_o_top_bulk_data.word_package_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.wordpackage.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_package_query_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.wordpackage.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_package_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：0c7f981383a63998c021ff1f11931620e0ebdcdb8d94936050c159827f8761be



---

# 删除词包

`taobao.universalbp.new.wordpackage.delete`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_command_list_v_o | WordPackageCommandListVO | 是 | 词操作列表对象 | — |
| word_package_command_list_v_o.word_package_list | WordPackageCommandVO [] | 是 | 词列表集合 | — |
| word_package_command_list_v_o.word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| word_package_command_list_v_o.word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| word_package_command_list_v_o.word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| word_package_command_list_v_o.word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| word_package_command_list_v_o.word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| word_package_command_list_v_o.word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| word_package_command_list_v_o.word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| word_package_command_list_v_o.word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| word_package_command_list_v_o.word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| word_package_command_list_v_o.word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| word_package_command_list_v_o.word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_delete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_delete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_delete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_delete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_delete_response.top_result.info.error_code |
| top_result.top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_wordpackage_delete_response.top_result.top_bulk_data |
| top_result.top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_delete_response.top_result.top_bulk_data.count |
| top_result.top_bulk_data.data_list | String [] | 未标注 | 业务条件集合 | 10,20 | universalbp_new_wordpackage_delete_response.top_result.top_bulk_data.data_list |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：a6a3946b602a12bcc45a90bc6083de7ad107c8e5521a687d298888cb5ac40a78



---

# 批量添加词包

`taobao.universalbp.new.wordpackage.add`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_package_add_request_v_o | WordPackageAddRequestVO | 是 | 词对象 | — |
| word_package_add_request_v_o.word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| word_package_add_request_v_o.word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| word_package_add_request_v_o.word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| word_package_add_request_v_o.word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| word_package_add_request_v_o.word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| word_package_add_request_v_o.word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| word_package_add_request_v_o.word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| word_package_add_request_v_o.word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| word_package_add_request_v_o.word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| word_package_add_request_v_o.word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| word_package_add_request_v_o.word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| word_package_add_request_v_o.word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_wordpackage_add_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_wordpackage_add_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_wordpackage_add_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_wordpackage_add_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_wordpackage_add_response.top_result.info.error_code |
| top_result.top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_wordpackage_add_response.top_result.top_bulk_data |
| top_result.top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_wordpackage_add_response.top_result.top_bulk_data.count |
| top_result.top_bulk_data.data_list | String [] | 未标注 | 业务条件集合 | 10,20 | universalbp_new_wordpackage_add_response.top_result.top_bulk_data.data_list |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.wordpackage.add",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_package_add_request_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.wordpackage.add\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_package_add_request_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 表示业务未完成。

来源校验 SHA256：fc43cfdde73ccdddbdf2313d66e54234e7ab9fa0a0cdf032ce4e1da9d06d5e3e



---

# 修改人群状态

`taobao.universalbp.new.crowd.horizontal.modifystatus`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_horizontal_modifystatus_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_horizontal_modifystatus_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_horizontal_modifystatus_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_horizontal_modifystatus_response.top_result.info.error_code |
| top_result.crowd_ref_update_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.count |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list | CrowdRefUpdateResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].campaign_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].adgroup_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].crowd_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_crowd_horizontal_modifystatus_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].count |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.horizontal.modifystatus",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_ref_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：446b24fc90fb8b00b903bde2fea195328e92950ca9480519a41296ec6823fe9f



---

# 修改人群出价

`taobao.universalbp.new.crowd.horizontal.modifybidprice`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_horizontal_modifybidprice_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.info.error_code |
| top_result.crowd_ref_update_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.count |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list | CrowdRefUpdateResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].campaign_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].adgroup_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].crowd_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_crowd_horizontal_modifybidprice_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].count |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.horizontal.modifybidprice",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_ref_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：e0b89e085b4b047b9e31ed12e78e659454504f73759ce2c44b4623cbdf8a04b6



---

# 修改人群溢价

`taobao.universalbp.new.crowd.horizontal.modifydiscount`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_horizontal_modifydiscount_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.info.error_code |
| top_result.crowd_ref_update_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.count |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list | CrowdRefUpdateResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].campaign_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].adgroup_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].crowd_id |
| top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_crowd_horizontal_modifydiscount_response.top_result.crowd_ref_update_result_v_o_top_bulk_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].count |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.horizontal.modifydiscount",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_ref_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：db6a1e53f0b7c977014bd1b72ac7aadae431f59fd1220ceb1d000bc43bae2502



---

# 查询推荐人群

`taobao.universalbp.new.crowd.findrecommendcrowd`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_rec_query_v_o | CrowdRecQueryVO | 是 | 人群查询对象 | — |
| crowd_rec_query_v_o.rec_scene_list | String [] | 否 | 业务条件集合；枚举：bd_sys=系统推荐人群、bd_ctr=行业榜单-点击率、bd_col_cart_rate=行业榜单-收藏加购、bd_cvr=行业榜单-转化率、bd_assist=行业榜单-助攻率、recSceneNew=关键词推广-新建流程、recSceneEffect=效果榜单、recSceneHeat=热度榜单、recSceneActivity=大促人群推荐、recSceneHomePage=首页榜单、recSceneAdgroupQualityOptions=单元列表智能拉新人群-优质组合推荐 | ["bd_sys"] |
| crowd_rec_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68795552573 |
| crowd_rec_query_v_o.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| crowd_rec_query_v_o.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| crowd_rec_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |
| crowd_rec_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type | item |
| crowd_rec_query_v_o.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type | item |
| crowd_rec_query_v_o.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 |
| crowd_rec_query_v_o.category | CategoryQueryVO | 否 | 业务对象 | — |
| crowd_rec_query_v_o.category.cat_id | Number | 否 | 业务对象标识 | 35 |
| crowd_rec_query_v_o.category.cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| crowd_rec_query_v_o.category.cat_level | Number | 否 | 业务字段 cat_level | 1 |
| crowd_rec_query_v_o.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 |
| crowd_rec_query_v_o.competition_instance_id | Number | 否 | 业务对象标识；枚举：7=行业明星探测、8=推广竞价探测、9=细分市场探测、10=关键词探测 | 7 |
| crowd_rec_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| crowd_rec_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_findrecommendcrowd_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_findrecommendcrowd_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_findrecommendcrowd_response.top_result.info.error_code |
| top_result.crowd_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 人群对象 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data |
| top_result.crowd_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.count |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list | CrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].campaign_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].adgroup_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].online_status |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.average_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.min_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.max_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.validate_bid_min |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.validate_bid_max |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.peer_avg_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].code |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].color |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.average_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.min_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.max_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.validate_bid_min |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.validate_bid_max |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.peer_avg_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_findrecommendcrowd_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.findrecommendcrowd",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_rec_query_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.crowd.findrecommendcrowd\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_rec_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：97e27b517eee82f850d089690e14f9629af80028bcfd08bc2a3e14e943f900f0



---

# 横向管理人群分页查询

`taobao.universalbp.new.crowd.horizontal.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_bind_query_v_o | CrowdBindQueryVO | 是 | 人群查询对象 | — |
| crowd_bind_query_v_o.offset | Number | 否 | 结果起始偏移 | 0 |
| crowd_bind_query_v_o.page_size | Number | 否 | 单页条数 | 20 |
| crowd_bind_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| crowd_bind_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| crowd_bind_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表；单元已经存在场景必填 | [68798447504] |
| crowd_bind_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| crowd_bind_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| crowd_bind_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| crowd_bind_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| crowd_bind_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| crowd_bind_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| crowd_bind_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| crowd_bind_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| crowd_bind_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_horizontal_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_horizontal_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_horizontal_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_horizontal_findpage_response.top_result.info.error_code |
| top_result.crowd_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 人群对象 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data |
| top_result.crowd_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.count |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list | CrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].campaign_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].adgroup_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].online_status |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].code |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].color |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_horizontal_findpage_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.horizontal.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_bind_query_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.crowd.horizontal.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_bind_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：938eef63d7ee74444871a7ff368e90f9d892da31cc11d5a4bde7a0deccb885e6



---

# 查询人群绑定列表

`taobao.universalbp.new.crowd.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_bind_query_list_v_o | CrowdBindQueryListVO | 是 | 人群查询列表对象 | — |
| crowd_bind_query_list_v_o.crowd_bind_query_list | CrowdBindQueryVO [] | 是 | 人群查询列表集合 | — |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].offset | Number | 否 | 结果起始偏移 | 0 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].page_size | Number | 否 | 单页条数 | 20 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].adgroup_id_list | Number [] | 否 | 单元标识列表；单元已经存在场景必填 | [68798447504] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_findlist_response.top_result.info.error_code |
| top_result.crowd_bind_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data |
| top_result.crowd_bind_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.count |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list | CrowdBindResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].campaign_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].adgroup_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list | CrowdRefVO [] | 未标注 | 人群列表 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].campaign_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].adgroup_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].online_status |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].code |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].color |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.show_tag_list.show_tag_v_o[].type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.bid_price | String | 未标注 | 出价金额 | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list | ShowTagVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].code | String | 未标注 | 结果或业务代码 | hign_cvr | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].code |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].name | String | 未标注 | 对象名称 | 高转化率 | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].tips | String | 未标注 | 业务字段 tips | xxxxxx | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].tips |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].icon |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].color | String | 未标注 | 业务字段 color | #FF4D4D | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].color |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].type | String | 未标注 | 类型 | display_ocpc | universalbp_new_crowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].show_tag_list.show_tag_v_o[].type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].show_tag_list[].properties | String | 未标注 | 扩展属性内容 | — | — |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：2924d5f55dfa8b0bd3d6c7b2c26b8a8c1dad9778ca1cbe75346e8af839ddc789



---

# 批量编辑人群

`taobao.universalbp.new.crowd.batchmodify`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | 183 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_batchmodify_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_batchmodify_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_batchmodify_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_batchmodify_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_batchmodify_response.top_result.info.error_code |
| top_result.crowd_ref_update_result_v_o_top_part_data | TopPartData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data |
| top_result.crowd_ref_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.count |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list | CrowdRefUpdateResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].campaign_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].adgroup_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].crowd_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].count |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_count |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.crowd_ref_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_crowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：059051649d8083cc0546ff328f7481de63eedd8958938099d993a5aeaa1030a4



---

# 批量删除绑定人群

`taobao.universalbp.new.crowd.batchdelete`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_batchdelete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_batchdelete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_batchdelete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_batchdelete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_batchdelete_response.top_result.info.error_code |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.count |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list | CrowdRefDeleteResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].campaign_id |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].adgroup_id |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_crowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].count |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：03fa97c544d7b73b5daf954f63e891af32d651f58a35b7d7b5afdcce1c62a891



---

# 从创意库添加查询创意列表

`taobao.universalbp.new.creative.getcreativebyconditionmap`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_query_v_o | CreativeQueryVO | 是 | 创意查询 | — |
| creative_query_v_o.status_list | String [] | 否 | 筛选状态集合；枚举：NR=不可投放、NP=投放中、NL=限制投放、NE=创意过期 | ["NP"] |
| creative_query_v_o.promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| creative_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714706341071] |
| creative_query_v_o.creative_id | Number | 否 | 广告创意编号 | 68792788612 |
| creative_query_v_o.type_list | String [] | 否 | 类型列表；枚举：STATIC=自定义创意、MATERIAL=主副图创意、MAIN_PIC_VIDEO=主图视频创意、AUTO=智能创意、AUTO_PACKAGE=智能创意包、MATERIAL_CREATIVE=素材化创意、black_creative=打底创意、white_creative=自定义创意、TEMPLATE_CREATIVE=模板创意、ALL_CREATIVE=全部创意 | ["MATERIAL_CREATIVE"] |
| creative_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| creative_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| creative_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| creative_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| creative_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| creative_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| creative_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| creative_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| creative_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| creative_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [68798447504] |
| creative_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| creative_query_v_o.web_scene | String | 否 | 业务字段 web_scene | find-canbind-creative:查询可绑定的创意列表, find-creative-detail:查询创意详情, creative-manager:创意管理 |
| creative_query_v_o.tab_type_list | String [] | 否 | 类型集合 | ["103"] |
| creative_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| creative_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_getcreativebyconditionmap_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.info.error_code |
| top_result.creative_v_o_top_bulk_data | TopBulkData | 未标注 | 创意对象 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data |
| top_result.creative_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list | CreativeVO [] | 未标注 | 创意列表 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | sss | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adgroup_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_center_id | String | 未标注 | 创意标识 | 225349579 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_center_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_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 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].template_id | Number | 未标注 | 模板标识 | 2000000000 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].template_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].outer_id | Number | 未标注 | 业务对象标识 | 225349579 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].outer_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].js_in_html |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].template_data | String | 未标注 | 业务字段 template_data | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].template_data |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].clickurl_media_type_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.tag_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.audit_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.audit_reason |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].tag_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 513x750 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].poster |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].duration |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].online_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].start_time | String | 未标注 | 查询或投放起始时间 | 2023-05-29 18:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].end_time | String | 未标注 | 查询或投放结束时间 | 2024-05-28 17:59:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].create_time | String | 未标注 | 业务字段 create_time | 2023-05-29 18:21:40 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].create_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].update_time | String | 未标注 | 业务字段 update_time | 2023-05-29 18:21:40 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].update_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.promotion_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_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 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.link_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.title |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].extend_data | String | 未标注 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].extend_data |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.sync_key |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_position |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.link_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_properties |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title | String | 未标注 | 展示标题 | 薄荷脑软膏,测试请不要拍 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].image_path | String | 未标注 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].click_url | String | 未标注 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].click_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_duration | String | 未标注 | 业务字段 video_duration | 10 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_duration |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_path | String | 未标注 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | [679056995041] | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_id_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].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 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].tab_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].tab_type_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].type_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].main_pic_video |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_count | Number | 未标注 | 业务字段 media_material_count | 5 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_count | Number | 未标注 | 业务字段 title_material_count | 5 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].outer_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].tag |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_position |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].sync_key |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].haitang_source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].origin_material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].content_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].content |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].origin_material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit_reject_info | String | 未标注 | 业务字段 audit_reject_info | xxxxx | universalbp_new_creative_getcreativebyconditionmap_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit_reject_info |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.getcreativebyconditionmap",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_query_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.creative.getcreativebyconditionmap\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：0847b18a907804e012e5680f941a49e68492bfbe4d535158b5db2269dd0bc23e



---

# 创意库查询创意列表

`taobao.universalbp.new.creative.manage.findmanagepage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_query_v_o | CreativeQueryVO | 是 | 创意查询 | — |
| creative_query_v_o.creative_id | Number | 否 | 广告创意编号 | 68792788612 |
| creative_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [68798447504] |
| creative_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| creative_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| creative_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_manage_findmanagepage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_manage_findmanagepage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_manage_findmanagepage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.info.error_code |
| top_result.creative_v_o_top_bulk_data | TopBulkData | 未标注 | 创意对象 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data |
| top_result.creative_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list | CreativeVO [] | 未标注 | 创意列表 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | sss | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adgroup_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_center_id | String | 未标注 | 创意标识 | 225349579 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_center_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_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 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].template_id | Number | 未标注 | 模板标识 | 2000000000 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].template_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].outer_id | Number | 未标注 | 业务对象标识 | 225349579 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].outer_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].js_in_html |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].template_data | String | 未标注 | 业务字段 template_data | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].template_data |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].clickurl_media_type_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.audit_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].audit.audit_reason |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 513x750 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].poster |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].duration |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].online_status |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].start_time | String | 未标注 | 查询或投放起始时间 | 2023-05-29 18:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].end_time | String | 未标注 | 查询或投放结束时间 | 2024-05-28 17:59:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].create_time | String | 未标注 | 业务字段 create_time | 2023-05-29 18:21:40 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].create_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].update_time | String | 未标注 | 业务字段 update_time | 2023-05-29 18:21:40 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].update_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.promotion_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_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 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.link_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].creative_promotion_entity.material.title |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].extend_data | String | 未标注 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].extend_data |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.sync_key |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_position |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.img_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.link_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.size |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].material_image_info.image_properties |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title | String | 未标注 | 展示标题 | 薄荷脑软膏,测试请不要拍 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].image_path | String | 未标注 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].click_url | String | 未标注 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].click_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_duration | String | 未标注 | 业务字段 video_duration | 10 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_duration |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_path | String | 未标注 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].video_image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | [679056995041] | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].item_id_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].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 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].tab_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].tab_type_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].type_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].main_pic_video |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_count | Number | 未标注 | 业务字段 media_material_count | 5 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_count | Number | 未标注 | 业务字段 title_material_count | 5 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_count |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].format |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_name |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].outer_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].tag |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_position |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_image_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_path |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].width |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].height |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].sync_key |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].haitang_source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].media_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].media_material_list.media_material_info_v_o[].origin_material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].creative_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].item_id |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].start_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].end_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].effective_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].expire_time |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].content_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].content |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].source |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].title_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_manage_findmanagepage_response.top_result.creative_v_o_top_bulk_data.creative_v_o_list.creative_v_o[].title_material_list.text_material_info_v_o[].origin_material_type |
| top_result.creative_v_o_top_bulk_data.creative_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.manage.findmanagepage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_query_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.creative.manage.findmanagepage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：e7d2fa5f140a7d6b4a0714bcd697e74cead34c52a23e8a9d1be7d1fd196f29e5



---

# 创建创意必要信息接口

`taobao.universalbp.new.creative.findrequire`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_require_query_v_o | CreativeRequireQueryVO | 是 | 创意查询对象 | — |
| creative_require_query_v_o.creative_set_mode | String | 否 | 业务字段 creative_set_mode；枚举：minimalist=极简版、professional=专业版 | professional |
| creative_require_query_v_o.creative_optimization | String | 否 | 业务字段 creative_optimization；枚举：black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | professional |
| creative_require_query_v_o.main_pic_video | String | 否 | 业务字段 main_pic_video；枚举：1=开、0=关 | 1 |
| creative_require_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_require_query_v_o.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_require_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_require_query_v_o.adgroup_list | AdgroupVO [] | 否 | 单元列表 | — |
| creative_require_query_v_o.adgroup_list[].gmt_create | Date | 否 | 业务字段 gmt_create | 2023-12-09 14:34:12 |
| creative_require_query_v_o.adgroup_list[].gmt_modified | Date | 否 | 业务字段 gmt_modified | 2023-12-09 14:34:12 |
| creative_require_query_v_o.adgroup_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_require_query_v_o.adgroup_list[].campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| creative_require_query_v_o.adgroup_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| creative_require_query_v_o.adgroup_list[].adgroup_name | String | 否 | 推广单元名称 | ds460418344 |
| creative_require_query_v_o.adgroup_list[].online_status | Number | 否 | 投放上下线状态；枚举：-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 |
| creative_require_query_v_o.adgroup_list[].display_status | String | 否 | 推广展示状态；枚举：pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause |
| creative_require_query_v_o.adgroup_list[].audit_status | Number | 否 | 业务字段 audit_status；枚举：-1=待审核、0=后台下线状态、1=后台上线状态 | 1 |
| creative_require_query_v_o.adgroup_list[].audit_reason | String | 否 | 业务字段 audit_reason | xxxxx |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc | AdgroupOcpcVO | 否 | 单元对象 | — |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：false=否、true=是 | true |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 否 | 业务字段 ocpc_marketing_aim | click |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_status | String | 否 | 业务字段 ocpc_status；枚举：new_ad_openable=可开启新广告加速、new_item_openable=可开启新品冷启动、new_ad_speeding=新广告加速加速中、new_item_speeding=新品冷启动加速中、new_ad_complete=新广告加速加速完成、new_item_complete=新品冷启动加速完成 | new_ad_complete |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.enable_cold_speed_new_item | Boolean | 否 | 业务字段 enable_cold_speed_new_item；枚举：true=是、false=否 | false |
| creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ecpc_option | Number | 否 | 业务字段 ecpc_option | 1 |
| creative_require_query_v_o.adgroup_list[].promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_require_query_v_o.adgroup_list[].sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_require_query_v_o.adgroup_list[].material | CommonMaterialVO | 否 | 素材 | — |
| creative_require_query_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_require_query_v_o.adgroup_list[].material.material_type | Number | 否 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 |
| creative_require_query_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_require_query_v_o.adgroup_list[].material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_require_query_v_o.adgroup_list[].material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_require_query_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_require_query_v_o.adgroup_list[].material.price | String | 否 | 金额 | 999900 |
| creative_require_query_v_o.adgroup_list[].material.bid_count | Number | 否 | 出价数量 | 899900 |
| creative_require_query_v_o.adgroup_list[].material.quantity | Number | 否 | 业务字段 quantity | 10 |
| creative_require_query_v_o.adgroup_list[].material.first_starts_time | Date | 否 | 业务字段 first_starts_time | 2023-04-26 14:51:03 |
| creative_require_query_v_o.adgroup_list[].material.starts | Date | 否 | 业务字段 starts | 2023-04-26 14:51:03 |
| creative_require_query_v_o.adgroup_list[].material.category_id | String | 否 | 业务对象标识 | 16 50010850 |
| creative_require_query_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_require_query_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 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合；列表中最多有2个元素 | — |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].type | Number | 否 | 类型 | 1 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_days | Number | 否 | 业务字段 life_cycle_days | 3 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_diff_with_avg | String | 否 | 业务字段 life_cycle_diff_with_avg | 较慢 |
| creative_require_query_v_o.adgroup_list[].material.life_cycle_diff_with_avg_tips | String | 否 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 |
| creative_require_query_v_o.adgroup_list[].material.grow_desc | String | 否 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 |
| creative_require_query_v_o.adgroup_list[].material.grow_rank | Number | 否 | 业务字段 grow_rank | 1077 |
| creative_require_query_v_o.adgroup_list[].alive_group_id | Number | 否 | 业务对象标识；枚举：0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 |
| creative_require_query_v_o.adgroup_list[].alive_group_name | String | 否 | 业务字段 alive_group_name | 宝贝链接(默认) |
| creative_require_query_v_o.adgroup_list[].black_creative_status | String | 否 | 业务字段 black_creative_status；枚举：success=合成成功、fail=合成失败 | success |
| creative_require_query_v_o.adgroup_list[].report_info_map | String | 否 | 业务字段 report_info_map | — |
| creative_require_query_v_o.adzone_list | AdzoneVO [] | 否 | 列表集合 | — |
| creative_require_query_v_o.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| creative_require_query_v_o.adzone_list[].adzone_name | String | 否 | 业务字段 adzone_name | 全屏微详情 |
| creative_require_query_v_o.adzone_list[].description | String | 否 | 业务字段 description | 首页及购中后的全屏微详情场景 |
| creative_require_query_v_o.adzone_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png |
| creative_require_query_v_o.promotion_scene | String | 否 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd |
| creative_require_query_v_o.optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| creative_require_query_v_o.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| creative_require_query_v_o.auto_wang_wang_picture | String | 否 | 业务字段 auto_wang_wang_picture；枚举：1=开、0=关 | 1 |
| creative_require_query_v_o.version | String | 否 | 业务字段 version | 2 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_findrequire_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_findrequire_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_findrequire_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_findrequire_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_findrequire_response.top_result.info.error_code |
| top_result.creative_require_v_o | CreativeRequireVO | 未标注 | 创意对象 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o |
| top_result.creative_require_v_o.is_special_category | Boolean | 未标注 | 业务字段 is_special_category；枚举：true=是、false=否 | true | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.is_special_category |
| top_result.creative_require_v_o.has_mini_detail_video | Boolean | 未标注 | 业务字段 has_mini_detail_video；枚举：true=是、false=否 | true | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.has_mini_detail_video |
| top_result.creative_require_v_o.creative_add_operators | String [] | 未标注 | 业务字段 creative_add_operators；枚举：video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_add_operators |
| top_result.creative_require_v_o.has_item_picture | Boolean | 未标注 | 业务字段 has_item_picture；枚举：true=是、false=否 | true | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.has_item_picture |
| top_result.creative_require_v_o.material_info_list | CreativeMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list |
| top_result.creative_require_v_o.material_info_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_id |
| top_result.creative_require_v_o.material_info_list[].is_active_item | Boolean | 未标注 | 业务字段 is_active_item；枚举：true=是、false=否 | false | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].is_active_item |
| top_result.creative_require_v_o.material_info_list[].is_special_category | Boolean | 未标注 | 业务字段 is_special_category；枚举：true=是、false=否 | false | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].is_special_category |
| top_result.creative_require_v_o.material_info_list[].has_mini_detail_video | Boolean | 未标注 | 业务字段 has_mini_detail_video；枚举：true=是、false=否 | false | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_mini_detail_video |
| top_result.creative_require_v_o.material_info_list[].mini_detail_video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].mini_detail_video_id |
| top_result.creative_require_v_o.material_info_list[].has_item_picture | Boolean | 未标注 | 业务字段 has_item_picture；枚举：true=是、false=否 | true | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_item_picture |
| top_result.creative_require_v_o.material_info_list[].has_auto_creative | Boolean | 未标注 | 业务字段 has_auto_creative；枚举：true=是、false=否 | true | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_auto_creative |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list | MaterialImageInfoVO [] | 未标注 | 素材图片列表集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].material_id |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].sync_key |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_position |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].img_url |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].link_url |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].material_name |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_id |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].size |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].width |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].height |
| top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_properties |
| top_result.creative_require_v_o.material_info_list[].material_video_list | MaterialVideoVO [] | 未标注 | 素材视频列表 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].tag | String | 未标注 | 业务字段 tag | tag | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].tag |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_id | Number | 未标注 | 视频标识 | 10101 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_id |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_url | String | 未标注 | 业务字段 mini_detail_video_url | http://localhost | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_url |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_image_path | String | 未标注 | 业务字段 mini_detail_video_image_path | http://localhost | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_image_path |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].width | Number | 未标注 | 业务字段 width | 100 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].width |
| top_result.creative_require_v_o.material_info_list[].material_video_list[].height | Number | 未标注 | 业务字段 height | 200 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].height |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list | MaterialImageInfoVO [] | 未标注 | 素材图片列表集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].material_id |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].sync_key |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_position |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].img_url |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].link_url |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].material_name |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_id |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].size |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].width |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].height |
| top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_properties |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list | MaterialImageInfoVO [] | 未标注 | 图片列表集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].material_id |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].sync_key |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_position |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].img_url |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].link_url |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].material_name |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_id |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].size |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].width |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].height |
| top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_properties |
| top_result.creative_require_v_o.creative_form_infos | CreativeFormInfoVO [] | 未标注 | 创意集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos |
| top_result.creative_require_v_o.creative_form_infos[].type | String | 未标注 | 类型；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].type |
| top_result.creative_require_v_o.creative_form_infos[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].format |
| top_result.creative_require_v_o.creative_form_infos[].width | Number | 未标注 | 业务字段 width | 100 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].width |
| top_result.creative_require_v_o.creative_form_infos[].height | Number | 未标注 | 业务字段 height | 200 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].height |
| top_result.creative_require_v_o.creative_form_infos[].num_limit | Number | 未标注 | 业务字段 num_limit | 12 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].num_limit |
| top_result.creative_require_v_o.creative_form_infos[].current_creative_num | Number | 未标注 | 业务字段 current_creative_num | 10 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].current_creative_num |
| top_result.creative_require_v_o.creative_form_infos[].tag | String | 未标注 | 业务字段 tag | tag | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].tag |
| top_result.creative_require_v_o.creative_form_infos[].text | String | 未标注 | 业务字段 text | 513x750 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].text |
| top_result.creative_require_v_o.creative_form_infos[].desc_info | String | 未标注 | 业务字段 desc_info | 竖版模板 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].desc_info |
| top_result.creative_require_v_o.creative_form_infos[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].content |
| top_result.creative_require_v_o.creative_form_infos[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].icon |
| top_result.creative_require_v_o.creative_form_infos[].creative_add_operators | String [] | 未标注 | 业务字段 creative_add_operators；枚举：video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].creative_add_operators |
| top_result.creative_require_v_o.creative_form_infos[].template_id | Number | 未标注 | 模板标识 | 202396 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].template_id |
| top_result.creative_require_v_o.smart_creative_form_infos | CreativeFormInfoVO [] | 未标注 | 创意集合 | — | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos |
| top_result.creative_require_v_o.smart_creative_form_infos[].type | String | 未标注 | 类型；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].type |
| top_result.creative_require_v_o.smart_creative_form_infos[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].format |
| top_result.creative_require_v_o.smart_creative_form_infos[].width | Number | 未标注 | 业务字段 width | 100 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].width |
| top_result.creative_require_v_o.smart_creative_form_infos[].height | Number | 未标注 | 业务字段 height | 200 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].height |
| top_result.creative_require_v_o.smart_creative_form_infos[].num_limit | Number | 未标注 | 业务字段 num_limit | 12 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].num_limit |
| top_result.creative_require_v_o.smart_creative_form_infos[].current_creative_num | Number | 未标注 | 业务字段 current_creative_num | 10 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].current_creative_num |
| top_result.creative_require_v_o.smart_creative_form_infos[].tag | String | 未标注 | 业务字段 tag | tag | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].tag |
| top_result.creative_require_v_o.smart_creative_form_infos[].text | String | 未标注 | 业务字段 text | 513x750 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].text |
| top_result.creative_require_v_o.smart_creative_form_infos[].desc_info | String | 未标注 | 业务字段 desc_info | 竖版模板 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].desc_info |
| top_result.creative_require_v_o.smart_creative_form_infos[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].content |
| top_result.creative_require_v_o.smart_creative_form_infos[].icon | String | 未标注 | 业务字段 icon | xxxxxx | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].icon |
| top_result.creative_require_v_o.smart_creative_form_infos[].creative_add_operators | String [] | 未标注 | 业务字段 creative_add_operators；枚举：video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].creative_add_operators |
| top_result.creative_require_v_o.smart_creative_form_infos[].template_id | Number | 未标注 | 模板标识 | 202396 | universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].template_id |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.findrequire",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_require_query_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.creative.findrequire\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_require_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：1dd457629bad8d0a45fe1fdd6f7640b2ea85f0df16647e99e7364bf1dfd0b2ad



---

# 预览创意

`taobao.universalbp.new.creative.preview`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_preview_query_v_o | CreativePreviewQueryVO | 是 | 创意查询对象 | — |
| creative_preview_query_v_o.adzone_list | AdzoneVO [] | 否 | 列表集合 | — |
| creative_preview_query_v_o.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| creative_preview_query_v_o.adzone_list[].adzone_name | String | 否 | 业务字段 adzone_name | 全屏微详情 |
| creative_preview_query_v_o.adzone_list[].description | String | 否 | 业务字段 description | 首页及购中后的全屏微详情场景 |
| creative_preview_query_v_o.adzone_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png |
| creative_preview_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_preview_query_v_o.creative | CreativeVO | 否 | 创意 | — |
| creative_preview_query_v_o.creative.creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_preview_query_v_o.creative.creative_name | String | 否 | 广告创意名称 | sss |
| creative_preview_query_v_o.creative.creative_type | Number | 否 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 |
| creative_preview_query_v_o.creative.source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_preview_query_v_o.creative.creative_center_id | String | 否 | 创意标识 | 225349579 |
| creative_preview_query_v_o.creative.tp_format | Number | 否 | 业务字段 tp_format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 |
| creative_preview_query_v_o.creative.material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_preview_query_v_o.creative.material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.creative.material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_preview_query_v_o.creative.material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_preview_query_v_o.creative.material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_preview_query_v_o.creative.material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_preview_query_v_o.creative.material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_preview_query_v_o.creative.material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_preview_query_v_o.creative.template_id | Number | 否 | 模板标识 | 2000000000 |
| creative_preview_query_v_o.creative.outer_id | Number | 否 | 业务对象标识 | 225349579 |
| creative_preview_query_v_o.creative.js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_preview_query_v_o.creative.template_data | String | 否 | 业务字段 template_data | — |
| creative_preview_query_v_o.creative.clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| creative_preview_query_v_o.creative.audit | AuditVO | 否 | 业务对象 | — |
| creative_preview_query_v_o.creative.audit.status | String | 否 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W |
| creative_preview_query_v_o.creative.audit.audit_status | Number | 否 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 |
| creative_preview_query_v_o.creative.audit.effective_time | String | 否 | 业务字段 effective_time | 2023-05-29 18:21:40 |
| creative_preview_query_v_o.creative.audit.expire_time | String | 否 | 业务字段 expire_time | 2999-12-31 23:59:59 |
| creative_preview_query_v_o.creative.audit.audit_reason | String | 否 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 |
| creative_preview_query_v_o.creative.adzone_audit_result_list | AuditVO [] | 否 | 结果列表集合 | — |
| creative_preview_query_v_o.creative.adzone_audit_result_list[].status | String | 否 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W |
| creative_preview_query_v_o.creative.adzone_audit_result_list[].audit_status | Number | 否 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 |
| creative_preview_query_v_o.creative.adzone_audit_result_list[].effective_time | String | 否 | 业务字段 effective_time | 2023-05-29 18:21:40 |
| creative_preview_query_v_o.creative.adzone_audit_result_list[].expire_time | String | 否 | 业务字段 expire_time | 2999-12-31 23:59:59 |
| creative_preview_query_v_o.creative.adzone_audit_result_list[].audit_reason | String | 否 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 |
| creative_preview_query_v_o.creative.preview_list | CreativeAdzonePreviewVO [] | 否 | 列表集合 | — |
| creative_preview_query_v_o.creative.preview_list[].adzone_type | Number | 否 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 |
| creative_preview_query_v_o.creative.preview_list[].adzone_name | String | 否 | 业务字段 adzone_name | 全屏微详情 |
| creative_preview_query_v_o.creative.preview_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list | CreativePreviewResultVO [] | 否 | 列表集合 | — |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_format | Number | 否 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_img_url | String | 否 | 业务字段 preview_img_url | — |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_click_url | String | 否 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_size | String | 否 | 业务字段 preview_size | 342x530 |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_scale | String | 否 | 业务字段 preview_scale | 0.5 |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_video_path | String | 否 | 业务字段 preview_video_path | 342x530 |
| creative_preview_query_v_o.creative.preview_list[].preview_data_list[].preview_video_image | String | 否 | 业务字段 preview_video_image | 342x530 |
| creative_preview_query_v_o.creative.creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| creative_preview_query_v_o.creative.item_videos | ItemVideoVO [] | 否 | 商品集合 | — |
| creative_preview_query_v_o.creative.item_videos[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_preview_query_v_o.creative.item_videos[].poster | String | 否 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg |
| creative_preview_query_v_o.creative.item_videos[].item_id | Number | 否 | 商品编号 | 708275631127 |
| creative_preview_query_v_o.creative.item_videos[].video_url | String | 否 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 |
| creative_preview_query_v_o.creative.item_videos[].audit_state | Number | 否 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 |
| creative_preview_query_v_o.creative.item_videos[].audit_desc | String | 否 | 业务字段 audit_desc | xxxxx |
| creative_preview_query_v_o.creative.item_videos[].video_id | Number | 否 | 视频标识 | 415780011227 |
| creative_preview_query_v_o.creative.item_videos[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_preview_query_v_o.creative.item_videos[].type | Number | 否 | 类型；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_preview_query_v_o.creative.item_videos[].width | Number | 否 | 业务字段 width | 800 |
| creative_preview_query_v_o.creative.item_videos[].height | Number | 否 | 业务字段 height | 1200 |
| creative_preview_query_v_o.creative.item_videos[].duration | Number | 否 | 业务字段 duration | 32 |
| creative_preview_query_v_o.creative.item_videos[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_preview_query_v_o.creative.online_status | Number | 否 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 |
| creative_preview_query_v_o.creative.start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| creative_preview_query_v_o.creative.end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| creative_preview_query_v_o.creative.create_time | String | 否 | 业务字段 create_time | 2023-05-29 18:21:40 |
| creative_preview_query_v_o.creative.update_time | String | 否 | 业务字段 update_time | 2023-05-29 18:21:40 |
| creative_preview_query_v_o.creative.creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| creative_preview_query_v_o.creative.creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_preview_query_v_o.creative.creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_preview_query_v_o.creative.creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| creative_preview_query_v_o.creative.creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| creative_preview_query_v_o.creative.creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.creative.creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_preview_query_v_o.creative.creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_preview_query_v_o.creative.creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_preview_query_v_o.creative.creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_preview_query_v_o.creative.extend_data | String | 否 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_preview_query_v_o.creative.material_image_info | MaterialImageInfoVO | 否 | 素材图片对象 | — |
| creative_preview_query_v_o.creative.material_image_info.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.creative.material_image_info.image_position | Number | 否 | 业务字段 image_position | 0 |
| creative_preview_query_v_o.creative.material_image_info.img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_preview_query_v_o.creative.material_image_info.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| creative_preview_query_v_o.creative.material_image_info.material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| creative_preview_query_v_o.creative.title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| creative_preview_query_v_o.creative.image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_preview_query_v_o.creative.click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| creative_preview_query_v_o.creative.video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_preview_query_v_o.creative.video_duration | String | 否 | 业务字段 video_duration | 10 |
| creative_preview_query_v_o.creative.video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| creative_preview_query_v_o.creative.video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| creative_preview_query_v_o.creative.item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| creative_preview_query_v_o.creative.children | CreativeChildrenVO [] | 否 | 业务集合 | — |
| creative_preview_query_v_o.creative.children[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_preview_query_v_o.creative.children[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.creative.children[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_preview_query_v_o.creative.children[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_preview_query_v_o.creative.children[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_preview_query_v_o.creative.children[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_preview_query_v_o.creative.children[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_preview_query_v_o.creative.children[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_preview_query_v_o.creative.tab_type | String | 否 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 |
| creative_preview_query_v_o.creative.tab_type_name | String | 否 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 |
| creative_preview_query_v_o.creative.type_name | String | 否 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 |
| creative_preview_query_v_o.creative.type | String | 否 | 类型；枚举：1=自定义创意、5=智能创意 | 1 |
| creative_preview_query_v_o.creative.main_pic_video | String | 否 | 业务字段 main_pic_video | 1 |
| creative_preview_query_v_o.creative.report_info_map | String | 否 | 业务字段 report_info_map | — |
| creative_preview_query_v_o.creative.adgroup_id | Number | 否 | 推广单元编号 | 68796878061 |
| creative_preview_query_v_o.material_image_info | MaterialImageInfoVO | 否 | 素材图片对象 | — |
| creative_preview_query_v_o.material_image_info.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.material_image_info.image_position | Number | 否 | 业务字段 image_position | 0 |
| creative_preview_query_v_o.material_image_info.img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_preview_query_v_o.material_image_info.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| creative_preview_query_v_o.material_image_info.material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| creative_preview_query_v_o.material_info | CommonMaterialVO | 否 | 素材对象 | — |
| creative_preview_query_v_o.material_info.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_preview_query_v_o.material_info.material_type | Number | 否 | 素材类型；枚举：1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 |
| creative_preview_query_v_o.material_info.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_preview_query_v_o.material_info.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_preview_query_v_o.material_info.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_preview_query_v_o.material_info.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_preview_query_v_o.material_info.price | String | 否 | 金额 | 999900 |
| creative_preview_query_v_o.material_info.bid_count | Number | 否 | 出价数量 | 899900 |
| creative_preview_query_v_o.material_info.quantity | Number | 否 | 业务字段 quantity | 10 |
| creative_preview_query_v_o.material_info.first_starts_time | Date | 否 | 业务字段 first_starts_time | 2023-04-26 14:51:03 |
| creative_preview_query_v_o.material_info.starts | Date | 否 | 业务字段 starts | 2023-04-26 14:51:03 |
| creative_preview_query_v_o.material_info.category_id | String | 否 | 业务对象标识 | 16 50010850 |
| creative_preview_query_v_o.material_info.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_preview_query_v_o.material_info.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_preview_query_v_o.material_info.life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合；列表中最多有2个元素 | — |
| creative_preview_query_v_o.material_info.life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| creative_preview_query_v_o.material_info.life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| creative_preview_query_v_o.material_info.life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| creative_preview_query_v_o.material_info.life_cycle_list[].type | Number | 否 | 类型 | 1 |
| creative_preview_query_v_o.material_info.life_cycle_days | Number | 否 | 业务字段 life_cycle_days | 3 |
| creative_preview_query_v_o.material_info.life_cycle_diff_with_avg | String | 否 | 业务字段 life_cycle_diff_with_avg | 较慢 |
| creative_preview_query_v_o.material_info.life_cycle_diff_with_avg_tips | String | 否 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 |
| creative_preview_query_v_o.material_info.grow_desc | String | 否 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 |
| creative_preview_query_v_o.material_info.grow_rank | Number | 否 | 业务字段 grow_rank | 1077 |
| creative_preview_query_v_o.promotion_scene | String | 否 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd |
| creative_preview_query_v_o.optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| creative_preview_query_v_o.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_preview_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_preview_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_preview_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_preview_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_preview_response.top_result.info.error_code |
| top_result.creative_adzone_preview_v_o_top_bulk_data | TopBulkData | 未标注 | 创意对象 | — | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data |
| top_result.creative_adzone_preview_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.count |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list | CreativeAdzonePreviewVO [] | 未标注 | 创意列表集合 | — | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_preview_response.top_result.creative_adzone_preview_v_o_top_bulk_data.creative_adzone_preview_v_o_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.preview",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_preview_query_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.creative.preview\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_preview_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：1b8cfb2f66ee7806313f273257679df4b71779bf8e3be91d00a9290f3ce808cf



---

# 创建单品创意前置信息

`taobao.universalbp.new.creative.preadd`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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_id_v_o | AdgroupIdVO | 是 | 单元标识 | — |
| adgroup_id_v_o.adgroup_id | Number | 是 | 推广单元编号 | 68793666608 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_preadd_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_preadd_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_preadd_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_preadd_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_preadd_response.top_result.info.error_code |
| top_result.pre_add_item_creative_v_o | PreAddItemCreativeVO | 未标注 | 商品创意对象 | — | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o |
| top_result.pre_add_item_creative_v_o.material | ItemMaterialVO | 未标注 | 素材 | — | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material |
| top_result.pre_add_item_creative_v_o.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.material_id |
| top_result.pre_add_item_creative_v_o.material.video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.video_id |
| top_result.pre_add_item_creative_v_o.material.source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.source |
| top_result.pre_add_item_creative_v_o.material.haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.haitang_id |
| top_result.pre_add_item_creative_v_o.material.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 | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.format_type |
| top_result.pre_add_item_creative_v_o.material.url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.url |
| top_result.pre_add_item_creative_v_o.material.cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.material.cover_url |
| top_result.pre_add_item_creative_v_o.have_long_sucai | Boolean | 未标注 | 业务字段 have_long_sucai | true | universalbp_new_creative_preadd_response.top_result.pre_add_item_creative_v_o.have_long_sucai |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.preadd",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adgroup_id_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.creative.preadd\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"adgroup_id_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：1207e4d2268f358a0d720f9e536cf94b2fd72a025a12908eff2c8c536091f3b5



---

# 横向管理创意分页查询

`taobao.universalbp.new.creative.horizontal.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_query_v_o | CreativeQueryVO | 是 | 创意查询 | — |
| creative_query_v_o.creative_id | Number | 否 | 广告创意编号 | 68792788612 |
| creative_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| creative_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| creative_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| creative_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| creative_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| creative_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| creative_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| creative_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| creative_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| creative_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [68798447504] |
| creative_query_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| creative_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| creative_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_horizontal_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_horizontal_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_horizontal_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_horizontal_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.info.error_code |
| top_result.creative_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 创意对象 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data |
| top_result.creative_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.count |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list | CreativeRefVO [] | 未标注 | 创意列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].campaign_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].campaign_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adgroup_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_id | Number | 未标注 | 广告创意编号 | 3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adgroup_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_center_id | String | 未标注 | 创意标识 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_center_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].format |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_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 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].template_id | Number | 未标注 | 模板标识 | 3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].template_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].outer_id | Number | 未标注 | 业务对象标识 | 3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].outer_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].js_in_html |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].template_data | String | 未标注 | 业务字段 template_data | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].template_data |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | Top,Pub | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].clickurl_media_type_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.audit_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.audit_reason |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.tag_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_reason_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_reason_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].redirect_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_block_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_block_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].block_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].remark |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | — | — |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.reason_list[].reason_dtos[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status_desc | String | 未标注 | 业务字段 status_desc | 创意有流量，部分流量受限制 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status_desc |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status_reasons | StatusReasonVO [] | 未标注 | 状态集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status_reasons |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status_reasons[].code | String | 未标注 | 结果或业务代码；枚举：creativeAuditing=审核中、creativeExpired=创意过期、materialPaused=素材暂停、materialMiss=缺少素材、materialReject=素材违规 | materialReject | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status_reasons.status_reason_v_o[].code |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status_reasons[].desc | String | 未标注 | 业务字段 desc | 素材违规 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status_reasons.status_reason_v_o[].desc |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].tag_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_reason_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_reason_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].redirect_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_block_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_block_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].block_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].remark |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | — | — |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].reason_dtos[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_dtos.reason_v_o[].audit_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_size |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].poster |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].width |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].height |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].duration |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].online_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].start_time | String | 未标注 | 查询或投放起始时间 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].start_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].end_time | String | 未标注 | 查询或投放结束时间 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].end_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].create_time | String | 未标注 | 业务字段 create_time | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].create_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].update_time | String | 未标注 | 业务字段 update_time | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].update_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.promotion_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_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 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.link_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.material_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.title |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].extend_data | String | 未标注 | 业务字段 extend_data | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].extend_data |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.sync_key |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.image_position |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.link_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.material_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.image_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.size |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.width |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.height |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.image_properties |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title | String | 未标注 | 展示标题 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].image_path | String | 未标注 | 业务字段 image_path | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].click_url | String | 未标注 | 业务字段 click_url | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].click_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_id | Number | 未标注 | 视频标识 | 3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_duration | String | 未标注 | 业务字段 video_duration | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_duration |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_path | String | 未标注 | 业务字段 video_path | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | 5,3 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_id_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].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 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].tab_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].tab_type_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].type_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].main_pic_video |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_count | Number | 未标注 | 业务字段 media_material_count | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_count |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_count | Number | 未标注 | 业务字段 title_material_count | 10 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_count |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].creative_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].format |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].start_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].end_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].material_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].outer_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].tag |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].item_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].image_position |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].video_image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].video_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].width |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].height |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].sync_key |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].image_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].material_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].haitang_source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].media_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].media_material_list.media_material_info_v_o[].origin_material_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].creative_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].item_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].start_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].end_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].content_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].content |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].material_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title_material_list.text_material_info_v_o[].origin_material_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit_reject_info | String | 未标注 | 业务字段 audit_reject_info | xxxxx | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit_reject_info |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].qzt_white | Number | 未标注 | 业务字段 qzt_white | 1 | universalbp_new_creative_horizontal_findpage_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].qzt_white |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.horizontal.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_query_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.creative.horizontal.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：54233ab515d92a0ef6aae3896eecf74bdc138b977d33caac1f4c68d9f51a5a55



---

# 计划已绑定创意查询

`taobao.universalbp.new.creative.getbindcreativelist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_ref_query_v_o | CreativeRefQueryVO | 是 | 创意查询对象 | — |
| creative_ref_query_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68792788657] |
| creative_ref_query_v_o.adgroup_id_list | Number [] | 否 | 单元标识列表 | [68798447504] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_getbindcreativelist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_getbindcreativelist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_getbindcreativelist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_getbindcreativelist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.info.error_code |
| top_result.creative_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 创意对象 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data |
| top_result.creative_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.count |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list | CreativeRefVO [] | 未标注 | 创意列表集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].campaign_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].campaign_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adgroup_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | ds460418344 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adgroup_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_id | Number | 未标注 | 广告创意编号 | 3 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 10 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 10 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_center_id | String | 未标注 | 创意标识 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_center_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 10 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].format |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_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 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].template_id | Number | 未标注 | 模板标识 | 3 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].template_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].outer_id | Number | 未标注 | 业务对象标识 | 3 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].outer_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].js_in_html |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].template_data | String | 未标注 | 业务字段 template_data | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].template_data |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | Top,Pub | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].clickurl_media_type_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.audit_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].audit.audit_reason |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_size |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].poster |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].width |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].height |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].duration |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 10 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].online_status |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].start_time | String | 未标注 | 查询或投放起始时间 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].start_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].end_time | String | 未标注 | 查询或投放结束时间 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].end_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].create_time | String | 未标注 | 业务字段 create_time | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].create_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].update_time | String | 未标注 | 业务字段 update_time | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].update_time |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.promotion_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_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 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.link_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.material_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].creative_promotion_entity.material.title |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].extend_data | String | 未标注 | 业务字段 extend_data | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].extend_data |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.image_position |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.img_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.link_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].material_image_info.material_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].title | String | 未标注 | 展示标题 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].title |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].image_path | String | 未标注 | 业务字段 image_path | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].click_url | String | 未标注 | 业务字段 click_url | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].click_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_id | Number | 未标注 | 视频标识 | 3 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_duration | String | 未标注 | 业务字段 video_duration | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_duration |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_path | String | 未标注 | 业务字段 video_path | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].video_image_path |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | 5,3 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].item_id_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].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 | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].tab_type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].tab_type_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].type_name |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].type |
| top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | xxxxx | universalbp_new_creative_getbindcreativelist_response.top_result.creative_ref_v_o_top_bulk_data.creative_ref_v_o_list.creative_ref_v_o[].main_pic_video |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.getbindcreativelist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_ref_query_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.creative.getbindcreativelist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_ref_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：1504abef34ef3c21025889f10cbe91e777d46188d49eab39db3beade466ce370



---

# 编辑创意

`taobao.universalbp.new.creative.update`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_command_list_v_o | CreativeCommandListVO | 是 | 创意操作列表 | — |
| creative_command_list_v_o.creative_list | CreativeCommandVO [] | 是 | 创意列表 | — |
| creative_command_list_v_o.creative_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| creative_command_list_v_o.creative_list[].creative_name | String | 否 | 广告创意名称 | sss |
| creative_command_list_v_o.creative_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| creative_command_list_v_o.creative_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| creative_command_list_v_o.creative_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| creative_command_list_v_o.creative_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| creative_command_list_v_o.creative_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| creative_command_list_v_o.creative_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| creative_command_list_v_o.creative_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| creative_command_list_v_o.creative_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| creative_command_list_v_o.creative_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| creative_command_list_v_o.creative_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_command_list_v_o.creative_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_command_list_v_o.creative_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_command_list_v_o.creative_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| creative_command_list_v_o.creative_list[].ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].template_data | String | 否 | 业务字段 template_data | — |
| creative_command_list_v_o.creative_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_command_list_v_o.creative_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| creative_command_list_v_o.creative_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| creative_command_list_v_o.creative_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| creative_command_list_v_o.creative_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| creative_command_list_v_o.creative_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| creative_command_list_v_o.creative_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| creative_command_list_v_o.creative_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| creative_command_list_v_o.creative_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| creative_command_list_v_o.creative_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| creative_command_list_v_o.creative_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| creative_command_list_v_o.creative_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_command_list_v_o.creative_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| creative_command_list_v_o.creative_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| creative_command_list_v_o.creative_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| creative_command_list_v_o.creative_list[].media_material_list[].source | Number | 否 | 请求来源标识；主副图、3:4主图、sku图必传；自定义素材非必传 | 1 |
| creative_command_list_v_o.creative_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| creative_command_list_v_o.creative_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position；枚举：3=4主图必传、0=主图、1=第一张副图、2=第二张副图、4=第四张副图、5；主副图、3:4主图必传；其他图非必传(只有商品主副图需要设置imagePosition | 1 |
| creative_command_list_v_o.creative_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| creative_command_list_v_o.creative_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| creative_command_list_v_o.creative_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| creative_command_list_v_o.creative_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| creative_command_list_v_o.creative_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| creative_command_list_v_o.creative_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_command_list_v_o.creative_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_command_list_v_o.creative_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| creative_command_list_v_o.creative_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| creative_command_list_v_o.creative_list[].media_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |
| creative_command_list_v_o.creative_list[].media_material_list[].image_properties | String | 否 | 业务字段 image_properties；sku图必传；其他图非必传 | 251005701:5342939018 |
| creative_command_list_v_o.creative_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_command_list_v_o.creative_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_command_list_v_o.creative_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| creative_command_list_v_o.creative_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| creative_command_list_v_o.creative_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_command_list_v_o.creative_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| creative_command_list_v_o.creative_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| creative_command_list_v_o.creative_list[].title_material_list[].origin_material_type | Number | 否 | 业务字段 origin_material_type | 121 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_update_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_update_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_update_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_update_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_update_response.top_result.info.error_code |
| top_result.top_creative_v_o | TopCreativeVO | 未标注 | 创意 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o |
| top_result.top_creative_v_o.creative_list | CreativeVO [] | 未标注 | 创意列表 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list |
| top_result.top_creative_v_o.creative_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].creative_name | String | 未标注 | 广告创意名称 | sss | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_name |
| top_result.top_creative_v_o.creative_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adgroup_id |
| top_result.top_creative_v_o.creative_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_type |
| top_result.top_creative_v_o.creative_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].source |
| top_result.top_creative_v_o.creative_list[].creative_center_id | String | 未标注 | 创意标识 | 225349579 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_center_id |
| top_result.top_creative_v_o.creative_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].format |
| top_result.top_creative_v_o.creative_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list |
| top_result.top_creative_v_o.creative_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].source |
| top_result.top_creative_v_o.creative_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_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 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].format_type |
| top_result.top_creative_v_o.creative_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].url |
| top_result.top_creative_v_o.creative_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].template_id | Number | 未标注 | 模板标识 | 2000000000 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_id |
| top_result.top_creative_v_o.creative_list[].outer_id | Number | 未标注 | 业务对象标识 | 225349579 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].outer_id |
| top_result.top_creative_v_o.creative_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].js_in_html |
| top_result.top_creative_v_o.creative_list[].template_data | String | 未标注 | 业务字段 template_data | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_data |
| top_result.top_creative_v_o.creative_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].clickurl_media_type_list |
| top_result.top_creative_v_o.creative_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit |
| top_result.top_creative_v_o.creative_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.status |
| top_result.top_creative_v_o.creative_list[].audit.tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.tag_name |
| top_result.top_creative_v_o.creative_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_status |
| top_result.top_creative_v_o.creative_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.effective_time |
| top_result.top_creative_v_o.creative_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.expire_time |
| top_result.top_creative_v_o.creative_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_reason |
| top_result.top_creative_v_o.creative_list[].audit.reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_id |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_name |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].block_url |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.top_creative_v_o.creative_list[].audit.reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].tag_name |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_id |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_name |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_url |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.top_creative_v_o.creative_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.top_creative_v_o.creative_list[].creative_size | String | 未标注 | 业务字段 creative_size | 513x750 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_size |
| top_result.top_creative_v_o.creative_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos |
| top_result.top_creative_v_o.creative_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].poster |
| top_result.top_creative_v_o.creative_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.top_creative_v_o.creative_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.top_creative_v_o.creative_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.top_creative_v_o.creative_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].source |
| top_result.top_creative_v_o.creative_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].type |
| top_result.top_creative_v_o.creative_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].width |
| top_result.top_creative_v_o.creative_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].height |
| top_result.top_creative_v_o.creative_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].duration |
| top_result.top_creative_v_o.creative_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].online_status |
| top_result.top_creative_v_o.creative_list[].start_time | String | 未标注 | 查询或投放起始时间 | 2023-05-29 18:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].end_time | String | 未标注 | 查询或投放结束时间 | 2024-05-28 17:59:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].create_time | String | 未标注 | 业务字段 create_time | 2023-05-29 18:21:40 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].create_time |
| top_result.top_creative_v_o.creative_list[].update_time | String | 未标注 | 业务字段 update_time | 2023-05-29 18:21:40 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].update_time |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_type |
| top_result.top_creative_v_o.creative_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 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_id |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.img_url |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.link_url |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_name |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.title |
| top_result.top_creative_v_o.creative_list[].extend_data | String | 未标注 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].extend_data |
| top_result.top_creative_v_o.creative_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info |
| top_result.top_creative_v_o.creative_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_id |
| top_result.top_creative_v_o.creative_list[].material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.sync_key |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_position |
| top_result.top_creative_v_o.creative_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.img_url |
| top_result.top_creative_v_o.creative_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.link_url |
| top_result.top_creative_v_o.creative_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_name |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_id |
| top_result.top_creative_v_o.creative_list[].material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.size |
| top_result.top_creative_v_o.creative_list[].material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.width |
| top_result.top_creative_v_o.creative_list[].material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.height |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_properties |
| top_result.top_creative_v_o.creative_list[].title | String | 未标注 | 展示标题 | 薄荷脑软膏,测试请不要拍 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title |
| top_result.top_creative_v_o.creative_list[].image_path | String | 未标注 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].image_path |
| top_result.top_creative_v_o.creative_list[].click_url | String | 未标注 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].click_url |
| top_result.top_creative_v_o.creative_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].video_duration | String | 未标注 | 业务字段 video_duration | 10 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_duration |
| top_result.top_creative_v_o.creative_list[].video_path | String | 未标注 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_path |
| top_result.top_creative_v_o.creative_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_image_path |
| top_result.top_creative_v_o.creative_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | [679056995041] | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_id_list |
| top_result.top_creative_v_o.creative_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children |
| top_result.top_creative_v_o.creative_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_list[].children[].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 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_type |
| top_result.top_creative_v_o.creative_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_type_name |
| top_result.top_creative_v_o.creative_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].type_name |
| top_result.top_creative_v_o.creative_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].type |
| top_result.top_creative_v_o.creative_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].main_pic_video |
| top_result.top_creative_v_o.creative_list[].media_material_count | Number | 未标注 | 业务字段 media_material_count | 5 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_count |
| top_result.top_creative_v_o.creative_list[].title_material_count | Number | 未标注 | 业务字段 title_material_count | 5 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_count |
| top_result.top_creative_v_o.creative_list[].media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list |
| top_result.top_creative_v_o.creative_list[].media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].format |
| top_result.top_creative_v_o.creative_list[].media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_name |
| top_result.top_creative_v_o.creative_list[].media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].outer_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].source |
| top_result.top_creative_v_o.creative_list[].media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].tag |
| top_result.top_creative_v_o.creative_list[].media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_position |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_image_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].width |
| top_result.top_creative_v_o.creative_list[].media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].height |
| top_result.top_creative_v_o.creative_list[].media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].sync_key |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_type |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].haitang_source |
| top_result.top_creative_v_o.creative_list[].media_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.top_creative_v_o.creative_list[].media_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].origin_material_type |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_properties | String | 未标注 | 业务字段 image_properties | 251005701:5342939018 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_properties |
| top_result.top_creative_v_o.creative_list[].title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list |
| top_result.top_creative_v_o.creative_list[].title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].content_type |
| top_result.top_creative_v_o.creative_list[].title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].content |
| top_result.top_creative_v_o.creative_list[].title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_type |
| top_result.top_creative_v_o.creative_list[].title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].source |
| top_result.top_creative_v_o.creative_list[].title_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.top_creative_v_o.creative_list[].title_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].origin_material_type |
| top_result.top_creative_v_o.creative_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.top_creative_v_o.creative_list[].audit_reject_info | String | 未标注 | 业务字段 audit_reject_info | xxxxx | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit_reject_info |
| top_result.top_creative_v_o.creative_list[].qzt_white | Number | 未标注 | 业务字段 qzt_white | 0 | universalbp_new_creative_update_response.top_result.top_creative_v_o.creative_list.creative_v_o[].qzt_white |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：faa6b918b22af55afcc33475fa613cf4af2c6335a20aa2b2d074c751fa6fee5a



---

# 创建创意

`taobao.universalbp.new.creative.add`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_command_list_v_o | CreativeCommandListVO | 是 | 创意操作列表 | — |
| creative_command_list_v_o.creative_list | CreativeCommandVO [] | 是 | 创意列表 | — |
| creative_command_list_v_o.creative_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].creative_name | String | 否 | 广告创意名称 | sss |
| creative_command_list_v_o.creative_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| creative_command_list_v_o.creative_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| creative_command_list_v_o.creative_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| creative_command_list_v_o.creative_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| creative_command_list_v_o.creative_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| creative_command_list_v_o.creative_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| creative_command_list_v_o.creative_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| creative_command_list_v_o.creative_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| creative_command_list_v_o.creative_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| creative_command_list_v_o.creative_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_command_list_v_o.creative_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_command_list_v_o.creative_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_command_list_v_o.creative_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].template_data | String | 否 | 业务字段 template_data | — |
| creative_command_list_v_o.creative_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_command_list_v_o.creative_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| creative_command_list_v_o.creative_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| creative_command_list_v_o.creative_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| creative_command_list_v_o.creative_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| creative_command_list_v_o.creative_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| creative_command_list_v_o.creative_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| creative_command_list_v_o.creative_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| creative_command_list_v_o.creative_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| creative_command_list_v_o.creative_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| creative_command_list_v_o.creative_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| creative_command_list_v_o.creative_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_command_list_v_o.creative_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| creative_command_list_v_o.creative_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| creative_command_list_v_o.creative_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| creative_command_list_v_o.creative_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| creative_command_list_v_o.creative_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| creative_command_list_v_o.creative_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| creative_command_list_v_o.creative_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| creative_command_list_v_o.creative_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| creative_command_list_v_o.creative_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| creative_command_list_v_o.creative_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| creative_command_list_v_o.creative_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| creative_command_list_v_o.creative_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| creative_command_list_v_o.creative_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_command_list_v_o.creative_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_command_list_v_o.creative_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| creative_command_list_v_o.creative_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_command_list_v_o.creative_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_command_list_v_o.creative_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_command_list_v_o.creative_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| creative_command_list_v_o.creative_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| creative_command_list_v_o.creative_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_command_list_v_o.creative_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| creative_command_list_v_o.creative_list[].creative_type | Number | 否 | 创意类型 | 20 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_add_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_add_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_add_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_add_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_add_response.top_result.info.error_code |
| top_result.top_creative_v_o | TopCreativeVO | 未标注 | 创意 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o |
| top_result.top_creative_v_o.creative_list | CreativeVO [] | 未标注 | 创意列表 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list |
| top_result.top_creative_v_o.creative_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].creative_name | String | 未标注 | 广告创意名称 | sss | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_name |
| top_result.top_creative_v_o.creative_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adgroup_id |
| top_result.top_creative_v_o.creative_list[].creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_type |
| top_result.top_creative_v_o.creative_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].source |
| top_result.top_creative_v_o.creative_list[].creative_center_id | String | 未标注 | 创意标识 | 225349579 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_center_id |
| top_result.top_creative_v_o.creative_list[].format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].format |
| top_result.top_creative_v_o.creative_list[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list |
| top_result.top_creative_v_o.creative_list[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].source |
| top_result.top_creative_v_o.creative_list[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_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 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].format_type |
| top_result.top_creative_v_o.creative_list[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].url |
| top_result.top_creative_v_o.creative_list[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].template_id | Number | 未标注 | 模板标识 | 2000000000 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_id |
| top_result.top_creative_v_o.creative_list[].outer_id | Number | 未标注 | 业务对象标识 | 225349579 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].outer_id |
| top_result.top_creative_v_o.creative_list[].js_in_html | String | 未标注 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].js_in_html |
| top_result.top_creative_v_o.creative_list[].template_data | String | 未标注 | 业务字段 template_data | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].template_data |
| top_result.top_creative_v_o.creative_list[].clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].clickurl_media_type_list |
| top_result.top_creative_v_o.creative_list[].audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit |
| top_result.top_creative_v_o.creative_list[].audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.status |
| top_result.top_creative_v_o.creative_list[].audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_status |
| top_result.top_creative_v_o.creative_list[].audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.effective_time |
| top_result.top_creative_v_o.creative_list[].audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.expire_time |
| top_result.top_creative_v_o.creative_list[].audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].audit.audit_reason |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].status |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.top_creative_v_o.creative_list[].preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.top_creative_v_o.creative_list[].preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.top_creative_v_o.creative_list[].preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.top_creative_v_o.creative_list[].creative_size | String | 未标注 | 业务字段 creative_size | 513x750 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_size |
| top_result.top_creative_v_o.creative_list[].item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos |
| top_result.top_creative_v_o.creative_list[].item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].poster |
| top_result.top_creative_v_o.creative_list[].item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_url |
| top_result.top_creative_v_o.creative_list[].item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_state |
| top_result.top_creative_v_o.creative_list[].item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].audit_desc |
| top_result.top_creative_v_o.creative_list[].item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].source |
| top_result.top_creative_v_o.creative_list[].item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].type |
| top_result.top_creative_v_o.creative_list[].item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].width |
| top_result.top_creative_v_o.creative_list[].item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].height |
| top_result.top_creative_v_o.creative_list[].item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].duration |
| top_result.top_creative_v_o.creative_list[].item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_videos.item_video_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].online_status |
| top_result.top_creative_v_o.creative_list[].start_time | String | 未标注 | 查询或投放起始时间 | 2023-05-29 18:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].end_time | String | 未标注 | 查询或投放结束时间 | 2024-05-28 17:59:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].create_time | String | 未标注 | 业务字段 create_time | 2023-05-29 18:21:40 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].create_time |
| top_result.top_creative_v_o.creative_list[].update_time | String | 未标注 | 业务字段 update_time | 2023-05-29 18:21:40 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].update_time |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_type |
| top_result.top_creative_v_o.creative_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 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.sub_promotion_type |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.promotion_entity_id |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_id |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.img_url |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.link_url |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.material_name |
| top_result.top_creative_v_o.creative_list[].creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].creative_promotion_entity.material.title |
| top_result.top_creative_v_o.creative_list[].extend_data | String | 未标注 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].extend_data |
| top_result.top_creative_v_o.creative_list[].material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info |
| top_result.top_creative_v_o.creative_list[].material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_id |
| top_result.top_creative_v_o.creative_list[].material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.sync_key |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_position |
| top_result.top_creative_v_o.creative_list[].material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.img_url |
| top_result.top_creative_v_o.creative_list[].material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.link_url |
| top_result.top_creative_v_o.creative_list[].material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.material_name |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_id |
| top_result.top_creative_v_o.creative_list[].material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.size |
| top_result.top_creative_v_o.creative_list[].material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.width |
| top_result.top_creative_v_o.creative_list[].material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.height |
| top_result.top_creative_v_o.creative_list[].material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].material_image_info.image_properties |
| top_result.top_creative_v_o.creative_list[].title | String | 未标注 | 展示标题 | 薄荷脑软膏,测试请不要拍 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title |
| top_result.top_creative_v_o.creative_list[].image_path | String | 未标注 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].image_path |
| top_result.top_creative_v_o.creative_list[].click_url | String | 未标注 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].click_url |
| top_result.top_creative_v_o.creative_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].video_duration | String | 未标注 | 业务字段 video_duration | 10 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_duration |
| top_result.top_creative_v_o.creative_list[].video_path | String | 未标注 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_path |
| top_result.top_creative_v_o.creative_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].video_image_path |
| top_result.top_creative_v_o.creative_list[].item_id_list | Number [] | 未标注 | 商品标识列表 | [679056995041] | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].item_id_list |
| top_result.top_creative_v_o.creative_list[].children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children |
| top_result.top_creative_v_o.creative_list[].children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.top_creative_v_o.creative_list[].children[].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 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.top_creative_v_o.creative_list[].children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.top_creative_v_o.creative_list[].tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_type |
| top_result.top_creative_v_o.creative_list[].tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].tab_type_name |
| top_result.top_creative_v_o.creative_list[].type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].type_name |
| top_result.top_creative_v_o.creative_list[].type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].type |
| top_result.top_creative_v_o.creative_list[].main_pic_video | String | 未标注 | 业务字段 main_pic_video | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].main_pic_video |
| top_result.top_creative_v_o.creative_list[].media_material_count | Number | 未标注 | 业务字段 media_material_count | 5 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_count |
| top_result.top_creative_v_o.creative_list[].title_material_count | Number | 未标注 | 业务字段 title_material_count | 5 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_count |
| top_result.top_creative_v_o.creative_list[].media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list |
| top_result.top_creative_v_o.creative_list[].media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].format |
| top_result.top_creative_v_o.creative_list[].media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_name |
| top_result.top_creative_v_o.creative_list[].media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].outer_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].source |
| top_result.top_creative_v_o.creative_list[].media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].tag |
| top_result.top_creative_v_o.creative_list[].media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_position |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_image_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].video_path |
| top_result.top_creative_v_o.creative_list[].media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].width |
| top_result.top_creative_v_o.creative_list[].media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].height |
| top_result.top_creative_v_o.creative_list[].media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].sync_key |
| top_result.top_creative_v_o.creative_list[].media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].image_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_type |
| top_result.top_creative_v_o.creative_list[].media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].media_material_list.media_material_info_v_o[].haitang_source |
| top_result.top_creative_v_o.creative_list[].title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list |
| top_result.top_creative_v_o.creative_list[].title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].creative_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].item_id |
| top_result.top_creative_v_o.creative_list[].title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].start_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].end_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].effective_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].expire_time |
| top_result.top_creative_v_o.creative_list[].title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].content_type |
| top_result.top_creative_v_o.creative_list[].title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].content |
| top_result.top_creative_v_o.creative_list[].title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].material_type |
| top_result.top_creative_v_o.creative_list[].title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_add_response.top_result.top_creative_v_o.creative_list.creative_v_o[].title_material_list.text_material_info_v_o[].source |
| top_result.top_creative_v_o.creative_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：db1a1868b911377277b0d38af31399c4d200891bd5d63cdde656acc8dd8b5a5f



---

# 绑定创意

`taobao.universalbp.new.creative.bind`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_ref_command_list_v_o | CreativeRefCommandListVO | 是 | 创意操作列表对象 | — |
| creative_ref_command_list_v_o.creative_ref_list | CreativeRefCommandVO [] | 是 | 创意列表集合 | — |
| creative_ref_command_list_v_o.creative_ref_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_ref_command_list_v_o.creative_ref_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_ref_command_list_v_o.creative_ref_list[].creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| creative_ref_command_list_v_o.creative_ref_list[].creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| creative_ref_command_list_v_o.creative_ref_list[].add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| creative_ref_command_list_v_o.creative_ref_list[].add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_bind_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_bind_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_bind_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_bind_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_bind_response.top_result.info.error_code |
| top_result.creative_ref_result_v_o_top_part_data | TopPartData | 未标注 | 创意结果对象 | — | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data |
| top_result.creative_ref_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.count |
| top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list | CreativeRefResultVO [] | 未标注 | 创意结果列表集合 | — | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list |
| top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list.creative_ref_result_v_o[].campaign_id |
| top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list.creative_ref_result_v_o[].adgroup_id |
| top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list.creative_ref_result_v_o[].creative_id |
| top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list[].reason | String | 未标注 | 业务字段 reason | xxxxx | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.creative_ref_result_v_o_list.creative_ref_result_v_o[].reason |
| top_result.creative_ref_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.error_count |
| top_result.creative_ref_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.error_details |
| top_result.creative_ref_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.creative_ref_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.creative_ref_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_creative_bind_response.top_result.creative_ref_result_v_o_top_part_data.error_details）

来源校验 SHA256：c02ec253fa931534b86856560d0c43ac8ff2e62b296f53aa7c1130cb6f9313e1



---

# 创意库创意部分编辑

`taobao.universalbp.new.creative.updatepart`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_command_list_v_o | CreativeCommandListVO | 是 | 创意操作列表 | — |
| creative_command_list_v_o.creative_list | CreativeCommandVO [] | 是 | 创意列表 | — |
| creative_command_list_v_o.creative_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_command_list_v_o.creative_list[].creative_name | String | 否 | 广告创意名称 | sss |
| creative_command_list_v_o.creative_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| creative_command_list_v_o.creative_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| creative_command_list_v_o.creative_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| creative_command_list_v_o.creative_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| creative_command_list_v_o.creative_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| creative_command_list_v_o.creative_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| creative_command_list_v_o.creative_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| creative_command_list_v_o.creative_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| creative_command_list_v_o.creative_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| creative_command_list_v_o.creative_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_command_list_v_o.creative_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_command_list_v_o.creative_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_command_list_v_o.creative_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_command_list_v_o.creative_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_command_list_v_o.creative_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_command_list_v_o.creative_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_command_list_v_o.creative_list[].template_data | String | 否 | 业务字段 template_data | — |
| creative_command_list_v_o.creative_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_command_list_v_o.creative_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| creative_command_list_v_o.creative_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| creative_command_list_v_o.creative_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| creative_command_list_v_o.creative_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| creative_command_list_v_o.creative_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| creative_command_list_v_o.creative_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| creative_command_list_v_o.creative_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| creative_command_list_v_o.creative_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_updatepart_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_updatepart_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_updatepart_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_updatepart_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_updatepart_response.top_result.info.error_code |
| top_result.top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_creative_updatepart_response.top_result.top_bulk_data |
| top_result.top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_updatepart_response.top_result.top_bulk_data.count |
| top_result.top_bulk_data.data_list | Number [] | 未标注 | 业务条件集合 | 5,3 | universalbp_new_creative_updatepart_response.top_result.top_bulk_data.data_list |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：7985cccc7cfd6a9b212bf62d7386eb20904e23dcab7fa51898afed565dc1bf81



---

# 保存创意和模板信息

`taobao.universalbp.new.creative.updatecreativeandtemplate`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_and_template_list_v_o | CreativeAndTemplateListVO | 是 | 创意模板列表对象 | — |
| creative_and_template_list_v_o.creative_and_template_list | CreativeAndTemplateCommandVO [] | 是 | 创意模板列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign | CampaignCommandVO | 否 | 计划 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_biz_code | String | 否 | 业务字段 campaign_biz_code | onebpDisplay |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_model | String | 否 | 业务字段 campaign_model | daily:持续推广,order:套餐包 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_model | String | 否 | 业务字段 promotion_model | daily:持续推广,order:套餐包 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_scene | String | 否 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_goals | String | 否 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.day_budget | Number | 否 | 日预算 | 100 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.total_budget | Number | 否 | 累计预算 | 100 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.budget_period | Number | 否 | 业务字段 budget_period | 7 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.sub_promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.item_rec_strategy_list | String [] | 否 | 商品集合 | ["effect_gmv","effect_coll"] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_items | Number [] | 否 | 业务字段 shield_items | [714707465203, 714901906337] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.scope_items | Number [] | 否 | 业务字段 scope_items | [714707465203, 714901906337] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.main_pic_video | String | 否 | 业务字段 main_pic_video | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.auto_wang_wang_pic | String | 否 | 业务字段 auto_wang_wang_pic | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.creative_optimization | String | 否 | 业务字段 creative_optimization；枚举：black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | black_creative |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.creative_set_mode | String | 否 | 业务字段 creative_set_mode；枚举：minimalist=极简版、professional=专业版 | professional |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["1","19"] 或者 ["all"] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories | CategoryCommandVO [] | 否 | 业务集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories[].cat_id | Number | 否 | 业务对象标识 | 35 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.shield_categories[].cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list | TrendThemeCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list[].trend_theme_id | Number | 否 | 业务对象标识 | 566987194 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.trend_theme_list[].trend_theme_name | String | 否 | 业务字段 trend_theme_name | 无边发光字 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_type | String | 否 | 业务字段 launch_period_type | xxxxx |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail | CampaignMiniDetailCommandVO | 否 | 业务对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.mini_detail_theme | String | 否 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203, 714901906337] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_top_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.mini_detail.private_mini_type | Number | 否 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list | CampaignCrowdFilterVO [] | 否 | 人群列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list[].behavior | String | 否 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_filter_list[].window | String | 否 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list | CampaignBrandFilterVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list[].brand_id | String | 否 | 业务对象标识 | 20067 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.brand_filter_list[].deeplink_list | String [] | 否 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list | DeeplinkBrandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list[].deeplink_brand_id | String | 否 | 业务对象标识 | 20067 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.deeplink_brand_list[].deeplink_brand_name | String | 否 | 业务字段 deeplink_brand_name | Lancome/兰蔻 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list | CampaignGenderAgeFilterVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list[].gender | String | 否 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.gender_age_filter_list[].age_list | String [] | 否 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.category_crowd_type | String | 否 | 业务字段 category_crowd_type；枚举：0=全域拉新、1=同类目拉新、2=跨类目拉新、7=OAI人群 | 0 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.target_crowd | String | 否 | 目标人群；枚举：ShopNew=店铺新客、brandNew=品牌新客 | ShopNew |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.scene_target | String | 否 | 业务字段 scene_target；枚举：InShopNew=新客访问、InterestNew=新客兴趣加深、BuyNew=新客成交 | BuyNew |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.source_channel | String | 否 | 业务字段 source_channel | adStrategyDurationPC |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.speed_type | String | 否 | 业务字段 speed_type | smooth |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.exposure_time | Number | 否 | 业务字段 exposure_time | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.plan_id | Number | 否 | 业务对象标识 | 260699 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info | CampaignOrderInfoVO | 否 | 业务对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.plan_id | Number | 否 | 业务对象标识 | 260699 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.plan_name | String | 否 | 业务字段 plan_name | 测试 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.order_amount | String | 否 | 业务字段 order_amount | 0.01 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.max_period | Number | 否 | 业务字段 max_period | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.min_period | Number | 否 | 业务字段 min_period | 3 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.order_info.total_stock | Number | 否 | 业务字段 total_stock | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.is_budget_schedule_open | Boolean | 否 | 业务字段 is_budget_schedule_open | true |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.market_aim_type | String | 否 | 业务字段 market_aim_type；枚举：fixed_target=固定目标、auto_trans=自动流转 | fixed_target |
| creative_and_template_list_v_o.creative_and_template_list[].campaign.smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list | AdgroupCommandVO [] | 否 | 单元列表 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 否 | 业务字段 ocpc_marketing_aim；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、new_item=新品冷启动、new_ad=新广告加速、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量 | click |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| creative_and_template_list_v_o.creative_and_template_list[].adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型 | 20 |

## 响应业务字段

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

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

## 本站请求结构

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

```json

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

```

## 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.creative.updatecreativeandtemplate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_and_template_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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

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


```

## 错误处理

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

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

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

- top_result.creative_and_template_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_creative_updatecreativeandtemplate_response.top_result.creative_and_template_result_v_o_top_part_data.error_details）

来源校验 SHA256：3da8fc42cf77e71c09b035c100b32bf37d6193f88fc3a7a567fd4b80437ef361



---

# 解绑创意

`taobao.universalbp.new.creative.unbind`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_ref_command_list_v_o | CreativeRefCommandListVO | 是 | 创意操作列表对象 | — |
| creative_ref_command_list_v_o.creative_ref_list | CreativeRefCommandVO [] | 是 | 创意列表集合 | — |
| creative_ref_command_list_v_o.creative_ref_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| creative_ref_command_list_v_o.creative_ref_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| creative_ref_command_list_v_o.creative_ref_list[].creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| creative_ref_command_list_v_o.creative_ref_list[].creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| creative_ref_command_list_v_o.creative_ref_list[].add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| creative_ref_command_list_v_o.creative_ref_list[].add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| creative_ref_command_list_v_o.creative_ref_list[].material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_unbind_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_unbind_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_unbind_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_unbind_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_unbind_response.top_result.info.error_code |
| top_result.top_creative_ref_result_v_o | TopCreativeRefResultVO | 未标注 | 创意结果对象 | — | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o |
| top_result.top_creative_ref_result_v_o.failed_list | CreativeRefResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o.failed_list |
| top_result.top_creative_ref_result_v_o.failed_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o.failed_list.creative_ref_result_v_o[].campaign_id |
| top_result.top_creative_ref_result_v_o.failed_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o.failed_list.creative_ref_result_v_o[].adgroup_id |
| top_result.top_creative_ref_result_v_o.failed_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o.failed_list.creative_ref_result_v_o[].creative_id |
| top_result.top_creative_ref_result_v_o.failed_list[].reason | String | 未标注 | 业务字段 reason | xxxxx | universalbp_new_creative_unbind_response.top_result.top_creative_ref_result_v_o.failed_list.creative_ref_result_v_o[].reason |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：a8a325fe65cdaf1572a05f7da49f5bb7c5475c23ac527c34e35f971cc01ca623



---

# 风控检查文本准入

`taobao.universalbp.new.shield.textjudge`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| shield_text_query_v_o | ShieldTextQueryVO | 是 | 查询对象 | — |
| shield_text_query_v_o.judged_text | String | 否 | 业务字段 judged_text | 联调内容渠道勿用，测试请不要拍 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_shield_textjudge_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_shield_textjudge_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_shield_textjudge_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_shield_textjudge_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_shield_textjudge_response.top_result.info.error_code |
| top_result.top_shield_text_v_o | TopShieldTextVO | 未标注 | 业务对象 | — | universalbp_new_shield_textjudge_response.top_result.top_shield_text_v_o |
| top_result.top_shield_text_v_o.error_message | String | 未标注 | 业务字段 error_message | 您输入的内容存在敏感词：XXX | universalbp_new_shield_textjudge_response.top_result.top_shield_text_v_o.error_message |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.shield.textjudge",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "shield_text_query_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.shield.textjudge\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"shield_text_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：78bd37d420b52046687b6afa8c1a256b5d7af30b1d44651b18179b593c0e5c2e



---

# 查询所有可用资源包信息

`taobao.universalbp.new.adzone.findconfiglist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adzone_findconfiglist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adzone_findconfiglist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adzone_findconfiglist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adzone_findconfiglist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adzone_findconfiglist_response.top_result.info.error_code |
| top_result.adzone_config_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data |
| top_result.adzone_config_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data.count |
| top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list | AdzoneConfigVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list |
| top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850200 | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list.adzone_config_v_o[].adzone_id |
| top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list[].discount | Boolean | 未标注 | 出价溢价 | true | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list.adzone_config_v_o[].discount |
| top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list[].aim_desc | String | 未标注 | 业务字段 aim_desc | 不支持促进曝光,预售蓄水,预热种草,爆发收割,提高互动量,提高加购量,提高成交量 | universalbp_new_adzone_findconfiglist_response.top_result.adzone_config_v_o_top_bulk_data.adzone_config_v_o_list.adzone_config_v_o[].aim_desc |

## 本站请求结构

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

```json

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

```

## 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.adzone.findconfiglist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：bfe79fda3bd83150da15aecc60caf7b8c5a65fef57e1a6e368f7773d41913716



---

# 获取类目过滤条件

`taobao.universalbp.new.stdcategory.findcategorycondition`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| std_category_query_v_o | StdCategoryQueryVO | 是 | 查询对象 | — |
| std_category_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |
| std_category_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| std_category_query_v_o.parent_cat_level | Number | 否 | 业务字段 parent_cat_level | 0 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_stdcategory_findcategorycondition_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_stdcategory_findcategorycondition_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_stdcategory_findcategorycondition_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_stdcategory_findcategorycondition_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_stdcategory_findcategorycondition_response.top_result.info.error_code |
| top_result.std_category_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data |
| top_result.std_category_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data.count |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list | StdCategoryVO [] | 未标注 | 列表集合 | — | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_id | Number | 未标注 | 业务对象标识 | 35 | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_id |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_name | String | 未标注 | 业务字段 cat_name | 童装/婴儿装/亲子装 | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_name |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_level | Number | 未标注 | 业务字段 cat_level | 1 | universalbp_new_stdcategory_findcategorycondition_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_level |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.stdcategory.findcategorycondition",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "std_category_query_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.stdcategory.findcategorycondition\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"std_category_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：2c09f847b943c462041e42288c660f586246b0d9ba347014dbd111a9d45fdfb6



---

# 宝贝所属类目查询

`taobao.universalbp.new.stdcategory.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| std_category_query_v_o | StdCategoryQueryVO | 是 | 查询对象 | — |
| std_category_query_v_o.material_id_list | Number [] | 否 | 素材标识列表 | [714894818852, 714901906337, 715106275342, 714813770503, 714707465203] |
| std_category_query_v_o.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| std_category_query_v_o.parent_cat_level | Number | 否 | 业务字段 parent_cat_level | 0 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_stdcategory_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_stdcategory_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_stdcategory_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_stdcategory_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_stdcategory_findlist_response.top_result.info.error_code |
| top_result.std_category_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data |
| top_result.std_category_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data.count |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list | StdCategoryVO [] | 未标注 | 列表集合 | — | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_id | Number | 未标注 | 业务对象标识 | 35 | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_id |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_name | String | 未标注 | 业务字段 cat_name | 童装/婴儿装/亲子装 | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_name |
| top_result.std_category_v_o_top_bulk_data.std_category_v_o_list[].cat_level | Number | 未标注 | 业务字段 cat_level | 1 | universalbp_new_stdcategory_findlist_response.top_result.std_category_v_o_top_bulk_data.std_category_v_o_list.std_category_v_o[].cat_level |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.stdcategory.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "std_category_query_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.stdcategory.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"std_category_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：3ae536f359e2db014d17fa85ffba2abd79ac222b4084ddc13b6ae7226d31892d



---

# 店铺相关类目查询

`taobao.universalbp.new.shopcategory.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_shopcategory_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_shopcategory_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_shopcategory_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_shopcategory_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_shopcategory_findlist_response.top_result.info.error_code |
| top_result.shop_category_v_o_top_bulk_data | TopBulkData | 未标注 | 店铺对象 | — | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data |
| top_result.shop_category_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data.count |
| top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list | ShopCategoryVO [] | 未标注 | 店铺列表集合 | — | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list |
| top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list[].category_id | Number | 未标注 | 业务对象标识 | 35 | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list.shop_category_v_o[].category_id |
| top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list[].category_name | String | 未标注 | 业务字段 category_name | 童装/婴儿装/亲子装 | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list.shop_category_v_o[].category_name |
| top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list[].parent_category_id | Number | 未标注 | 业务对象标识 | 0 | universalbp_new_shopcategory_findlist_response.top_result.shop_category_v_o_top_bulk_data.shop_category_v_o_list.shop_category_v_o[].parent_category_id |

## 本站请求结构

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

```json

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

```

## 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.shopcategory.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：620606cb50b5c1a78e912a268942c9f1098514d5d80b04dde2c8273cf19282e2



---

# 编辑计划组

`taobao.universalbp.new.campaigngroup.modify`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_group_command_v_o | CampaignGroupCommandVO | 是 | 计划操作对象 | — |
| campaign_group_command_v_o.biz_code | String | 是 | 推广场景标识 | onebpDisplay |
| campaign_group_command_v_o.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| campaign_group_command_v_o.campaign_group_name | String | 否 | 业务字段 campaign_group_name | 新建测试 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaigngroup_modify_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaigngroup_modify_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaigngroup_modify_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaigngroup_modify_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaigngroup_modify_response.top_result.info.error_code |
| top_result.campaign_group_update_result_v_o | CampaignGroupUpdateResultVO | 未标注 | 计划结果对象 | — | universalbp_new_campaigngroup_modify_response.top_result.campaign_group_update_result_v_o |
| top_result.campaign_group_update_result_v_o.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaigngroup_modify_response.top_result.campaign_group_update_result_v_o.count |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaigngroup.modify",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_group_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.campaigngroup.modify\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_group_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 表示业务未完成。

来源校验 SHA256：0e8253cbd4b1a2002cb6ec6e48072d3c7b3684ef19978b76df10bc7f35fb4b60



---

# 查询计划组列表

`taobao.universalbp.new.campaigngroup.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_group_query_v_o | CampaignGroupQueryVO | 是 | 计划查询对象 | — |
| campaign_group_query_v_o.biz_code | String | 是 | 推广场景标识 | onebpDisplay |
| campaign_group_query_v_o.campaign_group_name | String | 否 | 业务字段 campaign_group_name | 新建测试 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaigngroup_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaigngroup_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaigngroup_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaigngroup_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaigngroup_findlist_response.top_result.info.error_code |
| top_result.campaign_group_v_o_top_bulk_data | TopBulkData | 未标注 | 计划对象 | — | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data |
| top_result.campaign_group_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data.count |
| top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list | CampaignGroupVO [] | 未标注 | 计划列表集合 | — | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list |
| top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list[].campaign_group_biz_code | String | 未标注 | 业务字段 campaign_group_biz_code | onebpDisplay | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list.campaign_group_v_o[].campaign_group_biz_code |
| top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list[].campaign_group_id | Number | 未标注 | 计划标识 | 25481004 | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list.campaign_group_v_o[].campaign_group_id |
| top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list[].campaign_group_name | String | 未标注 | 业务字段 campaign_group_name | 新建测试 | universalbp_new_campaigngroup_findlist_response.top_result.campaign_group_v_o_top_bulk_data.campaign_group_v_o_list.campaign_group_v_o[].campaign_group_name |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaigngroup.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_group_query_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.campaigngroup.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_group_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：5bed0089aa1982ef1f2f0262f83d79814f82415fdbf07862b1ca2a74b0a1ab05



---

# 新增计划组

`taobao.universalbp.new.campaigngroup.add`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_group_command_v_o | CampaignGroupCommandVO | 是 | 计划操作对象 | — |
| campaign_group_command_v_o.biz_code | String | 是 | 推广场景标识 | onebpDisplay |
| campaign_group_command_v_o.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| campaign_group_command_v_o.campaign_group_name | String | 否 | 业务字段 campaign_group_name | 新建测试 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaigngroup_add_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaigngroup_add_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaigngroup_add_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaigngroup_add_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaigngroup_add_response.top_result.info.error_code |
| top_result.campaign_group_add_result_v_o | CampaignGroupAddResultVO | 未标注 | 计划结果对象 | — | universalbp_new_campaigngroup_add_response.top_result.campaign_group_add_result_v_o |
| top_result.campaign_group_add_result_v_o.campaign_group_id | Number | 未标注 | 计划标识 | 25481004 | universalbp_new_campaigngroup_add_response.top_result.campaign_group_add_result_v_o.campaign_group_id |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaigngroup.add",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_group_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.campaigngroup.add\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_group_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 表示业务未完成。

来源校验 SHA256：a846ac7bfe364903e12bccb67b442249cf7a5df0e5becbc2e4890c2c7cf53efd



---

# 获取出价建议

`taobao.universalbp.new.algo.getbidsuggestion`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| algo_query_v_o | AlgoQueryVO | 是 | 查询对象 | — |
| algo_query_v_o.campaign | AlgoCampaignQueryVO | 否 | 计划 | — |
| algo_query_v_o.campaign.campaign_id | Number | 否 | 推广计划编号 | 68799007001 |
| algo_query_v_o.campaign.promotion_model | String | 否 | 业务字段 promotion_model | display |
| algo_query_v_o.campaign.promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| algo_query_v_o.campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy | new_ad_similar |
| algo_query_v_o.campaign.promotion_goals | String | 否 | 业务字段 promotion_goals | shop_crowd |
| algo_query_v_o.campaign.optimize_target | String | 否 | 优化目标 | shop_visit_new |
| algo_query_v_o.campaign.dmc_type | String | 否 | 预算方式标识 | normal |
| algo_query_v_o.campaign.day_budget | Number | 否 | 日预算 | 60 |
| algo_query_v_o.campaign.reap_all_budget | Number | 否 | 业务字段 reap_all_budget | 60 |
| algo_query_v_o.campaign.old_budget | Number | 否 | 业务字段 old_budget | 500 |
| algo_query_v_o.campaign.total_budget | Number | 否 | 累计预算 | 350 |
| algo_query_v_o.campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| algo_query_v_o.campaign.budget_period | Number | 否 | 业务字段 budget_period | 1 |
| algo_query_v_o.campaign.bid_type | String | 否 | 出价类型 | roi_control |
| algo_query_v_o.campaign.constraint_type | String | 否 | 业务字段 constraint_type | roi |
| algo_query_v_o.campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| algo_query_v_o.campaign.old_constraint_value | String | 否 | 业务字段 old_constraint_value | 2.5 |
| algo_query_v_o.campaign.promotion_type | String | 否 | 业务字段 promotion_type | item |
| algo_query_v_o.campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode | user_define |
| algo_query_v_o.campaign.item_rec_strategy | String [] | 否 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
| algo_query_v_o.campaign.is_quick_lift | Boolean | 否 | 业务字段 is_quick_lift | true |
| algo_query_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| algo_query_v_o.campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| algo_query_v_o.campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| algo_query_v_o.campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| algo_query_v_o.campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| algo_query_v_o.campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| algo_query_v_o.campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| algo_query_v_o.campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| algo_query_v_o.campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| algo_query_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| algo_query_v_o.campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| algo_query_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| algo_query_v_o.campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| algo_query_v_o.campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| algo_query_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| algo_query_v_o.campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| algo_query_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| algo_query_v_o.campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| algo_query_v_o.campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| algo_query_v_o.campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| algo_query_v_o.campaign.word_list | WordCommandVO [] | 否 | 词列表 | — |
| algo_query_v_o.campaign.word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| algo_query_v_o.campaign.word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| algo_query_v_o.campaign.word_list[].word | String | 否 | 词 | 鞋原创小众 |
| algo_query_v_o.campaign.word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| algo_query_v_o.campaign.word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| algo_query_v_o.campaign.word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| algo_query_v_o.campaign.word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| algo_query_v_o.campaign.search_upgrade_pxb | Number | 否 | 业务字段 search_upgrade_pxb | 0 |
| algo_query_v_o.campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| algo_query_v_o.campaign.algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | {} |
| algo_query_v_o.campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| algo_query_v_o.campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| algo_query_v_o.campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| algo_query_v_o.campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| algo_query_v_o.campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| algo_query_v_o.campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| algo_query_v_o.campaign.is_multi_target | Boolean | 否 | 业务字段 is_multi_target | true |
| algo_query_v_o.campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| algo_query_v_o.campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| algo_query_v_o.adgroup_list | AlgoAdgroupQueryVO [] | 否 | 单元列表 | — |
| algo_query_v_o.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| algo_query_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| algo_query_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| algo_query_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| algo_query_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 |
| algo_query_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| algo_query_v_o.effect_type_list | String [] | 否 | 类型集合 | ["gmv"] |
| algo_query_v_o.dmc_type_element | String | 否 | 业务字段 dmc_type_element | dayBudget |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_algo_getbidsuggestion_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_algo_getbidsuggestion_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_algo_getbidsuggestion_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_algo_getbidsuggestion_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_algo_getbidsuggestion_response.top_result.info.error_code |
| top_result.bid_suggest_v_o | BidSuggestVO | 未标注 | 出价建议 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o |
| top_result.bid_suggest_v_o.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.campaign_id |
| top_result.bid_suggest_v_o.bid_min | String | 未标注 | 出价最小 | 4.17 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_min |
| top_result.bid_suggest_v_o.bid_max | String | 未标注 | 出价最大 | 16.66 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_max |
| top_result.bid_suggest_v_o.bid_left | String | 未标注 | 业务字段 bid_left | 6.66 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_left |
| top_result.bid_suggest_v_o.bid_middle | String | 未标注 | 业务字段 bid_middle | 8.33 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle |
| top_result.bid_suggest_v_o.bid_right | String | 未标注 | 业务字段 bid_right | 9.66 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_right |
| top_result.bid_suggest_v_o.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.10 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.validate_bid_min |
| top_result.bid_suggest_v_o.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 10.00 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.validate_bid_max |
| top_result.bid_suggest_v_o.adzone_suggest_discount_list | AdzoneSuggestDiscountVO [] | 未标注 | 建议列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_suggest_discount_list |
| top_result.bid_suggest_v_o.adzone_suggest_discount_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850197 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_suggest_discount_list.adzone_suggest_discount_v_o[].adzone_id |
| top_result.bid_suggest_v_o.adzone_suggest_discount_list[].suggest_discount | Number | 未标注 | 业务字段 suggest_discount | 35 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_suggest_discount_list.adzone_suggest_discount_v_o[].suggest_discount |
| top_result.bid_suggest_v_o.adzone_list | AdzoneRefVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list |
| top_result.bid_suggest_v_o.adzone_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].adzone_id |
| top_result.bid_suggest_v_o.adzone_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].adzone_name |
| top_result.bid_suggest_v_o.adzone_list[].min_discount | Number | 未标注 | 业务字段 min_discount | 1 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].min_discount |
| top_result.bid_suggest_v_o.adzone_list[].max_discount | Number | 未标注 | 业务字段 max_discount | 30 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].max_discount |
| top_result.bid_suggest_v_o.adzone_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].campaign_id |
| top_result.bid_suggest_v_o.adzone_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].campaign_name |
| top_result.bid_suggest_v_o.adzone_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].bid_type |
| top_result.bid_suggest_v_o.adzone_list[].discount | Number | 未标注 | 出价溢价 | 0 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].discount |
| top_result.bid_suggest_v_o.adzone_list[].fit_discount | Number | 未标注 | 业务字段 fit_discount | 0 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].fit_discount |
| top_result.bid_suggest_v_o.adzone_list[].status | String | 未标注 | 状态标识；枚举：start=投放、pause=暂停 | start | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].status |
| top_result.bid_suggest_v_o.adzone_list[].operation_list | OperationVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].operation_list |
| top_result.bid_suggest_v_o.adzone_list[].operation_list[].code | String | 未标注 | 结果或业务代码 | 12 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].code |
| top_result.bid_suggest_v_o.adzone_list[].operation_list[].name | String | 未标注 | 对象名称 | 操作 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].name |
| top_result.bid_suggest_v_o.adzone_list[].operation_list[].tips | String | 未标注 | 业务字段 tips | xxxx | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].tips |
| top_result.bid_suggest_v_o.adzone_list[].operation_list[].disabled | Boolean | 未标注 | 业务字段 disabled | false | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].disabled |
| top_result.bid_suggest_v_o.adzone_list[].operation_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o.adzone_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.bid_suggest_v_o.crowd_suggest_price_list | CrowdSuggestPriceVO [] | 未标注 | 人群建议金额列表 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list |
| top_result.bid_suggest_v_o.crowd_suggest_price_list[].target_type | Number | 未标注 | 目标类型 | 100 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list.crowd_suggest_price_v_o[].target_type |
| top_result.bid_suggest_v_o.crowd_suggest_price_list[].option_value | String | 未标注 | 业务字段 option_value | 31536383 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list.crowd_suggest_price_v_o[].option_value |
| top_result.bid_suggest_v_o.crowd_suggest_price_list[].price_upper | String | 未标注 | 业务字段 price_upper | 0.71 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list.crowd_suggest_price_v_o[].price_upper |
| top_result.bid_suggest_v_o.crowd_suggest_price_list[].price_lower | String | 未标注 | 业务字段 price_lower | 0.48 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list.crowd_suggest_price_v_o[].price_lower |
| top_result.bid_suggest_v_o.crowd_suggest_price_list[].price_middle | String | 未标注 | 业务字段 price_middle | 0.60 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_suggest_price_list.crowd_suggest_price_v_o[].price_middle |
| top_result.bid_suggest_v_o.crowd_list | CrowdRefVO [] | 未标注 | 人群列表 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list |
| top_result.bid_suggest_v_o.crowd_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].campaign_id |
| top_result.bid_suggest_v_o.crowd_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].adgroup_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd_id |
| top_result.bid_suggest_v_o.crowd_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].online_status |
| top_result.bid_suggest_v_o.crowd_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd |
| top_result.bid_suggest_v_o.crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.bid_suggest_v_o.crowd_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.target_type |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.average_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.min_fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.max_fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_min |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_max |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.price.peer_avg_price |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.bid_suggest_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.bid_suggest_v_o.crowd_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.bid_suggest_v_o.crowd_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.bid_suggest_v_o.crowd_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.bid_suggest_v_o.crowd_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price |
| top_result.bid_suggest_v_o.crowd_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.bid_price |
| top_result.bid_suggest_v_o.crowd_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.average_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.min_fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.max_fit_bid_price |
| top_result.bid_suggest_v_o.crowd_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.validate_bid_min |
| top_result.bid_suggest_v_o.crowd_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.validate_bid_max |
| top_result.bid_suggest_v_o.crowd_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.discount |
| top_result.bid_suggest_v_o.crowd_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.fit_discount |
| top_result.bid_suggest_v_o.crowd_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.crowd_list.crowd_ref_v_o[].price.peer_avg_price |
| top_result.bid_suggest_v_o.crowd_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.bid_suggest_v_o.bid_middle_effect | EffectPredictVO | 未标注 | 出价对象 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect |
| top_result.bid_suggest_v_o.bid_middle_effect.pv | Number | 未标注 | 业务字段 pv | 1621 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.pv |
| top_result.bid_suggest_v_o.bid_middle_effect.pv_low | Number | 未标注 | 业务字段 pv_low | 1297 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.pv_low |
| top_result.bid_suggest_v_o.bid_middle_effect.pv_high | Number | 未标注 | 业务字段 pv_high | 1945 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.pv_high |
| top_result.bid_suggest_v_o.bid_middle_effect.click | Number | 未标注 | 点击次数 | 97 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.click |
| top_result.bid_suggest_v_o.bid_middle_effect.click_low | Number | 未标注 | 业务字段 click_low | 78 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.click_low |
| top_result.bid_suggest_v_o.bid_middle_effect.click_high | Number | 未标注 | 业务字段 click_high | 117 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.click_high |
| top_result.bid_suggest_v_o.bid_middle_effect.conv | Number | 未标注 | 业务字段 conv | 13 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.conv |
| top_result.bid_suggest_v_o.bid_middle_effect.conv_low | Number | 未标注 | 业务字段 conv_low | 10 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.conv_low |
| top_result.bid_suggest_v_o.bid_middle_effect.conv_high | Number | 未标注 | 业务字段 conv_high | 15 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.conv_high |
| top_result.bid_suggest_v_o.bid_middle_effect.wconv | Number | 未标注 | 业务字段 wconv | 27 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.wconv |
| top_result.bid_suggest_v_o.bid_middle_effect.wconv_low | Number | 未标注 | 业务字段 wconv_low | 22 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.wconv_low |
| top_result.bid_suggest_v_o.bid_middle_effect.wconv_high | Number | 未标注 | 业务字段 wconv_high | 33 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.wconv_high |
| top_result.bid_suggest_v_o.bid_middle_effect.mem | Number | 未标注 | 业务字段 mem | 0 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.mem |
| top_result.bid_suggest_v_o.bid_middle_effect.mem_low | Number | 未标注 | 业务字段 mem_low | 0 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.mem_low |
| top_result.bid_suggest_v_o.bid_middle_effect.mem_high | Number | 未标注 | 业务字段 mem_high | 1 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.mem_high |
| top_result.bid_suggest_v_o.bid_middle_effect.cost | String | 未标注 | 业务字段 cost；计量单位：元 | 823.83 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cost |
| top_result.bid_suggest_v_o.bid_middle_effect.cost_low | String | 未标注 | 业务字段 cost_low；计量单位：元 | 659.06 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cost_low |
| top_result.bid_suggest_v_o.bid_middle_effect.cost_high | String | 未标注 | 业务字段 cost_high；计量单位：元 | 988.60 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cost_high |
| top_result.bid_suggest_v_o.bid_middle_effect.cart | Number | 未标注 | 业务字段 cart | 10 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cart |
| top_result.bid_suggest_v_o.bid_middle_effect.cart_low | Number | 未标注 | 业务字段 cart_low | 5 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cart_low |
| top_result.bid_suggest_v_o.bid_middle_effect.cart_high | Number | 未标注 | 业务字段 cart_high | 15 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.cart_high |
| top_result.bid_suggest_v_o.bid_middle_effect.uv_aim_low | Number | 未标注 | 业务字段 uv_aim_low | 5 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.uv_aim_low |
| top_result.bid_suggest_v_o.bid_middle_effect.uv_aim_high | Number | 未标注 | 业务字段 uv_aim_high | 15 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.uv_aim_high |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv | String | 未标注 | 业务字段 gmv | 6845.21 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_net | String | 未标注 | 业务字段 gmv_net | 6845.21 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_net |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_low | String | 未标注 | 业务字段 gmv_low | 5476.17 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_low |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_high | String | 未标注 | 业务字段 gmv_high | 8214.26 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_high |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_low_net | String | 未标注 | 业务字段 gmv_low_net | 5476.17 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_low_net |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_high_net | String | 未标注 | 业务字段 gmv_high_net | 8214.26 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_high_net |
| top_result.bid_suggest_v_o.bid_middle_effect.min_gmv | String | 未标注 | 业务字段 min_gmv | 5476.17 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.min_gmv |
| top_result.bid_suggest_v_o.bid_middle_effect.max_gmv | String | 未标注 | 业务字段 max_gmv | 8214.26 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.max_gmv |
| top_result.bid_suggest_v_o.bid_middle_effect.success_ratio_high | String | 未标注 | 业务字段 success_ratio_high | 0.9 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.success_ratio_high |
| top_result.bid_suggest_v_o.bid_middle_effect.success_ratio_low | String | 未标注 | 业务字段 success_ratio_low | 0.8 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.success_ratio_low |
| top_result.bid_suggest_v_o.bid_middle_effect.gmv_diff_percent | String | 未标注 | 业务字段 gmv_diff_percent | 0.67 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.gmv_diff_percent |
| top_result.bid_suggest_v_o.bid_middle_effect.effect_predict_reason | String | 未标注 | 业务字段 effect_predict_reason | 预计曝光量<span number=\"highlight\">+20%</span>，自然流量助推<span number=\"error\">+10%</span> | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.effect_predict_reason |
| top_result.bid_suggest_v_o.bid_middle_effect.reason | String | 未标注 | 业务字段 reason | 预计可获得点击量2次 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_middle_effect.reason |
| top_result.bid_suggest_v_o.bid_rec_reason | String | 未标注 | 业务字段 bid_rec_reason | 商品昨日搜索点击量低于2，同行同层平均目标投产比为5.84，建议投产比设置不超过10.31，获取更多点击。大促期建议考虑确收因素，设置更合理的ROI。 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_rec_reason |
| top_result.bid_suggest_v_o.bid_info_list | BidInfoVO [] | 未标注 | 出价列表集合 | — | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list |
| top_result.bid_suggest_v_o.bid_info_list[].value | String | 未标注 | 值 | 1.92 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list.bid_info_v_o[].value |
| top_result.bid_suggest_v_o.bid_info_list[].tag | String | 未标注 | 业务字段 tag | 性价比推荐 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list.bid_info_v_o[].tag |
| top_result.bid_suggest_v_o.bid_info_list[].is_default | Boolean | 未标注 | 业务字段 is_default | false | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list.bid_info_v_o[].is_default |
| top_result.bid_suggest_v_o.bid_info_list[].tag_mode | String | 未标注 | 业务字段 tag_mode | AI小万 | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list.bid_info_v_o[].tag_mode |
| top_result.bid_suggest_v_o.bid_info_list[].reason | String | 未标注 | 业务字段 reason | 采纳后预计可获得点击量提出7% | universalbp_new_algo_getbidsuggestion_response.top_result.bid_suggest_v_o.bid_info_list.bid_info_v_o[].reason |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.algo.getbidsuggestion",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "algo_query_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.algo.getbidsuggestion\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"algo_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：6c5efd12e1e215439c421e9834a3b60e49c3d1224a8c66a62d5f18ad0404709a



---

# 查看资源包列表

`taobao.universalbp.new.adzone.horizontal.findpage`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| adzone_ref_query_v_o | AdzoneRefQueryVO | 是 | 查询对象 | — |
| adzone_ref_query_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68792788657] |
| adzone_ref_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| adzone_ref_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| adzone_ref_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| adzone_ref_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| adzone_ref_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| adzone_ref_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| adzone_ref_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| adzone_ref_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| adzone_ref_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| adzone_ref_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| adzone_ref_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adzone_horizontal_findpage_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adzone_horizontal_findpage_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adzone_horizontal_findpage_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adzone_horizontal_findpage_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adzone_horizontal_findpage_response.top_result.info.error_code |
| top_result.adzone_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data |
| top_result.adzone_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.count |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list | AdzoneRefVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].adzone_id |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].adzone_name |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].campaign_id |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].campaign_name |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].bid_type |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].discount | Number | 未标注 | 出价溢价 | 0 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].discount |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].fit_discount | Number | 未标注 | 业务字段 fit_discount | 0 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].fit_discount |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].status | String | 未标注 | 状态标识；枚举：start=投放、pause=暂停 | start | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].status |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list | OperationVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].operation_list |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list[].code | String | 未标注 | 结果或业务代码 | 12 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].operation_list.operation_v_o[].code |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list[].name | String | 未标注 | 对象名称 | 操作 | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].operation_list.operation_v_o[].name |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list[].tips | String | 未标注 | 业务字段 tips | xxxx | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].operation_list.operation_v_o[].tips |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list[].disabled | Boolean | 未标注 | 业务字段 disabled | false | universalbp_new_adzone_horizontal_findpage_response.top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list.adzone_ref_v_o[].operation_list.operation_v_o[].disabled |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].operation_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.adzone_ref_v_o_top_bulk_data.adzone_ref_v_o_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.adzone.horizontal.findpage",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adzone_ref_query_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.adzone.horizontal.findpage\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"adzone_ref_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：8d741523a849fc355328269461f565894c0b43d033ac6e4904057376f355b6db



---

# 地域报表查询

`taobao.universalbp.new.report.query.area`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_area_report_query_v_o | TopAreaReportQueryVO | 是 | 地域报表查询 | — |
| top_area_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_area_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_area_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_area_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_area_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_area_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_area_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [province] |
| top_area_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_area_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | ["onebpDisplay"] |
| top_area_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_area_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_area_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_area_report_query_v_o.adzone_pkg_id_in_list | Number [] | 否 | 标识集合 | [68798644117] |
| top_area_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_area_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_area_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_area_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_area_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_area_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_area_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_area_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_area_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_area_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.area",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_area_report_query_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.report.query.area\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_area_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：2e9fe5606c11dd867f364a812755ecd875850103a40404ddace943519a906d94



---

# 创意报表查询

`taobao.universalbp.new.report.query.creative`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_creative_report_query_v_o | TopCreativeReportQueryVO | 是 | 创意报表查询 | — |
| top_creative_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_creative_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_creative_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_creative_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_creative_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_creative_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_creative_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [creative] |
| top_creative_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_creative_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | ["onebpDisplay"] |
| top_creative_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_creative_report_query_v_o.strategy_creative_id_or_name | String | 否 | 业务字段 strategy_creative_id_or_name | 商品 |
| top_creative_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_creative_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_creative_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_creative_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_creative_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_creative_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_creative_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_creative_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_creative_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_creative_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_creative_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_creative_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.creative",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_creative_report_query_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.report.query.creative\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_creative_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：9f01af7138816ba21aa8353118dad9e37b041144a785c621d033be5d35f1356a



---

# 其他主体报表查询

`taobao.universalbp.new.report.query.not.item.promotion`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_other_promotion_report_query_v_o | TopOtherPromotionReportQueryVO | 是 | 报表查询对象 | — |
| top_other_promotion_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_other_promotion_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_other_promotion_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_other_promotion_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_other_promotion_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_other_promotion_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_other_promotion_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [promotion] |
| top_other_promotion_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_other_promotion_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | ["onebpDisplay"] |
| top_other_promotion_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_other_promotion_report_query_v_o.sub_promotion_types | String [] | 否 | 业务字段 sub_promotion_types | [USER_DEFINE_URL] |
| top_other_promotion_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_other_promotion_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_other_promotion_report_query_v_o.strategy_adgroup_id_in_list | Number [] | 否 | 单元标识集合 | [68798644117] |
| top_other_promotion_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_other_promotion_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_other_promotion_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_other_promotion_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_not_item_promotion_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_not_item_promotion_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_not_item_promotion_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_not_item_promotion_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_not_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.not.item.promotion",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_other_promotion_report_query_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.report.query.not.item.promotion\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_other_promotion_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：5b53789feff9665954066421189567683205bd8a024d3b95928a107ef4f1d927



---

# 宝贝主体报表查询

`taobao.universalbp.new.report.query.item.promotion`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_item_promotion_report_query_v_o | TopItemPromotionReportQueryVO | 是 | 商品报表查询对象 | — |
| top_item_promotion_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_item_promotion_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_item_promotion_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_item_promotion_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_item_promotion_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_item_promotion_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_item_promotion_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [promotion] |
| top_item_promotion_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_item_promotion_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | ["onebpDisplay"] |
| top_item_promotion_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_item_promotion_report_query_v_o.item_ids | Number [] | 否 | 业务字段 item_ids | [68798644117] |
| top_item_promotion_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_item_promotion_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_item_promotion_report_query_v_o.item_id_or_name | String | 否 | 业务字段 item_id_or_name | 连衣裙长裙 |
| top_item_promotion_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_item_promotion_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_item_promotion_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_item_promotion_report_query_v_o.sub_promotion_types | String [] | 否 | 业务字段 sub_promotion_types | ["ITEM_PRIVATE_MINI","SHOP","USER_DEFINE_URL","SHORT_VIDEO","ITEM","RSS_CONTENT"] |
| top_item_promotion_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_item_promotion_report_query_v_o.short_video_ids | Number [] | 否 | 业务字段 short_video_ids | [487403761722] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_item_promotion_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_item_promotion_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_item_promotion_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_item_promotion_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_item_promotion_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.item.promotion",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_item_promotion_report_query_v_o": {
      "by_page": true,
      "split_type": "day",
      "unify_type": "last_click_by_effect_time",
      "effect_equal": 15,
      "start_time": "2026-11-17",
      "end_time": "2026-11-17",
      "query_domains": [
        "date",
        "promotion"
      ],
      "query_field_in_list": [
        "adPv",
        "click",
        "charge",
        "alipayInshopAmt",
        "alipayInshopNum"
      ],
      "biz_code_in_list": [
        "onebpSite"
      ],
      "offset": 0,
      "page_size": 100,
      "source": "baseReport"
    }
  }
}

```

## 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.report.query.item.promotion\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_item_promotion_report_query_v_o\":{\"by_page\":true,\"split_type\":\"day\",\"unify_type\":\"last_click_by_effect_time\",\"effect_equal\":15,\"start_time\":\"2026-11-17\",\"end_time\":\"2026-11-17\",\"query_domains\":[\"date\",\"promotion\"],\"query_field_in_list\":[\"adPv\",\"click\",\"charge\",\"alipayInshopAmt\",\"alipayInshopNum\"],\"biz_code_in_list\":[\"onebpSite\"],\"offset\":0,\"page_size\":100,\"source\":\"baseReport\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：89a90a7c6d3810270cc1042bffeae9da393a1e8dd6dbbdf6ce95296ea4685b7a



---

# 人群报表查询

`taobao.universalbp.new.report.query.crowd`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_crowd_report_query_v_o | TopCrowdReportQueryVO | 是 | 人群报表查询 | — |
| top_crowd_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_crowd_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_crowd_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_crowd_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_crowd_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_crowd_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_crowd_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [crowd] |
| top_crowd_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_crowd_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_crowd_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_crowd_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_crowd_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_crowd_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_crowd_report_query_v_o.strategy_target_title_like | String | 否 | 业务字段 strategy_target_title_like | 消费 |
| top_crowd_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_crowd_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_crowd_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_crowd_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_crowd_report_query_v_o.filter_append_subway_channel | Boolean | 否 | 业务字段 filter_append_subway_channel | true |
| top_crowd_report_query_v_o.filter_null_crowd_subway_tag | Boolean | 否 | 业务字段 filter_null_crowd_subway_tag | true |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_crowd_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_crowd_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_crowd_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_crowd_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_crowd_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_crowd_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.crowd",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_crowd_report_query_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.report.query.crowd\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_crowd_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：34a2b200c313daebfb188aff146929b6d1f5fba38ef6120f0a428ed1aa1d558e



---

# 关键词报表查询

`taobao.universalbp.new.report.query.bidword`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_bid_word_report_query_v_o | TopBidWordReportQueryVO | 是 | 出价词报表查询 | — |
| top_bid_word_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_bid_word_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_bid_word_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_bid_word_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_bid_word_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_bid_word_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_bid_word_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | ["account", "campaign"] |
| top_bid_word_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_bid_word_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_bid_word_report_query_v_o.adzone_pkg_id_in_list | Number [] | 否 | 标识集合 | [68798644117] |
| top_bid_word_report_query_v_o.strategy_adgroup_id_in_list | Number [] | 否 | 单元标识集合 | [68798644117] |
| top_bid_word_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_bid_word_report_query_v_o.strategy_adgroup_id_or_name | String | 否 | 业务字段 strategy_adgroup_id_or_name | 连衣裙长裙 |
| top_bid_word_report_query_v_o.bid_word_type_in_list | String [] | 否 | 出价词类型集合 | [word, wordPkg] |
| top_bid_word_report_query_v_o.strategy_bidword_name_like | String | 否 | 业务字段 strategy_bidword_name_like | 红裙 |
| top_bid_word_report_query_v_o.strategy_bidword_pkg_name_like | String | 否 | 业务字段 strategy_bidword_pkg_name_like | 红裙 |
| top_bid_word_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_bid_word_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_bid_word_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_bidword_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_bidword_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_bidword_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_bidword_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_bidword_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_bidword_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.bidword",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_bid_word_report_query_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.report.query.bidword\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_bid_word_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：11f09356d09e8874db0328c427dd130dc88e0d0df9a826e199224e970efd0782



---

# 单元报表查询

`taobao.universalbp.new.report.query.adgroup`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_adgroup_report_query_v_o | TopAdgroupReportQueryVO | 是 | 单元报表查询 | — |
| top_adgroup_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_adgroup_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_adgroup_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_adgroup_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_adgroup_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_adgroup_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_adgroup_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [account, campaign] |
| top_adgroup_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_adgroup_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_adgroup_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_adgroup_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_adgroup_report_query_v_o.strategy_adgroup_id_in_list | Number [] | 否 | 单元标识集合 | [68798644117] |
| top_adgroup_report_query_v_o.adzone_pkg_id_in_list | Number [] | 否 | 标识集合 | [68798644117] |
| top_adgroup_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_adgroup_report_query_v_o.item_id_or_name | String | 否 | 业务字段 item_id_or_name | 连衣裙长裙 |
| top_adgroup_report_query_v_o.strategy_adgroup_id_or_name | String | 否 | 业务字段 strategy_adgroup_id_or_name | 连衣裙长裙 |
| top_adgroup_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_adgroup_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_adgroup_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_adgroup_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_adgroup_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_adgroup_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_adgroup_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions | TopPromotionVO [] | 未标注 | 业务集合 | — | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_id | Number | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type | 11 | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type_str | String | 未标注 | 业务字段 sub_promotion_type_str | ITEM | universalbp_new_report_query_adgroup_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type_str |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.adgroup",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_adgroup_report_query_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.report.query.adgroup\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_adgroup_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：851a28f423716b35017f07349acf5b04cd79eaff9418c919d8b05f100d775c31



---

# 计划报表查询

`taobao.universalbp.new.report.query.campaign`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_campaign_report_query_v_o | TopCampaignReportQueryVO | 是 | 计划报表查询 | — |
| top_campaign_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_campaign_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_campaign_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_campaign_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_campaign_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_campaign_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_campaign_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [date, campaign] |
| top_campaign_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_campaign_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_campaign_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_campaign_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_campaign_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_campaign_report_query_v_o.item_id_or_name | String | 否 | 业务字段 item_id_or_name | 连衣裙长裙 |
| top_campaign_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_campaign_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_campaign_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_campaign_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_campaign_report_query_v_o.strategy_promotion_mode_in_list | String [] | 否 | 业务条件集合 | daily |
| top_campaign_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_campaign_report_query_v_o.strategy_str_dmc_type_in_list | String [] | 否 | 类型集合 | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_campaign_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_campaign_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_campaign_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_campaign_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_campaign_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions | TopPromotionVO [] | 未标注 | 业务集合 | — | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_id | Number | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type | 11 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type_str | String | 未标注 | 业务字段 sub_promotion_type_str | ITEM | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type_str |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_campaign_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.campaign",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_campaign_report_query_v_o": {
      "by_page": true,
      "split_type": "day",
      "unify_type": "last_click_by_effect_time",
      "effect_equal": 15,
      "start_time": "2026-11-17",
      "end_time": "2026-11-17",
      "query_domains": [
        "date",
        "campaign"
      ],
      "query_field_in_list": [
        "adPv",
        "click",
        "charge",
        "alipayInshopAmt",
        "alipayInshopNum"
      ],
      "biz_code_in_list": [
        "onebpSite"
      ],
      "offset": 0,
      "page_size": 100,
      "source": "baseReport"
    }
  }
}

```

## 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.report.query.campaign\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_campaign_report_query_v_o\":{\"by_page\":true,\"split_type\":\"day\",\"unify_type\":\"last_click_by_effect_time\",\"effect_equal\":15,\"start_time\":\"2026-11-17\",\"end_time\":\"2026-11-17\",\"query_domains\":[\"date\",\"campaign\"],\"query_field_in_list\":[\"adPv\",\"click\",\"charge\",\"alipayInshopAmt\",\"alipayInshopNum\"],\"biz_code_in_list\":[\"onebpSite\"],\"offset\":0,\"page_size\":100,\"source\":\"baseReport\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：95b4001a71cd613a8b834a51b9305051ea5b11abb0e1270b7eb5f7ed9ea80160



---

# 账户报表查询

`taobao.universalbp.new.report.query.account`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_account_report_query_v_o | TopAccountReportQueryVO | 是 | 账户报表查询 | — |
| top_account_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_account_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_account_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_account_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_account_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_account_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_account_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [account, campaign] |
| top_account_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | [adPv] |
| top_account_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_account_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_account_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_account_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_account_report_query_v_o.strategy_promotion_mode_in_list | String [] | 否 | 业务条件集合 | daily |
| top_account_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_account_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_account_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_account_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_account_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_account_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_account_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.account",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_account_report_query_v_o": {
      "by_page": true,
      "split_type": "day",
      "unify_type": "last_click_by_effect_time",
      "effect_equal": 15,
      "start_time": "2026-11-17",
      "end_time": "2026-11-17",
      "query_domains": [
        "date"
      ],
      "query_field_in_list": [
        "adPv",
        "click",
        "charge",
        "alipayInshopAmt",
        "alipayInshopNum"
      ],
      "biz_code_in_list": [
        "onebpSite"
      ],
      "offset": 0,
      "page_size": 100,
      "source": "baseReport"
    }
  }
}

```

## 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.report.query.account\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_account_report_query_v_o\":{\"by_page\":true,\"split_type\":\"day\",\"unify_type\":\"last_click_by_effect_time\",\"effect_equal\":15,\"start_time\":\"2026-11-17\",\"end_time\":\"2026-11-17\",\"query_domains\":[\"date\"],\"query_field_in_list\":[\"adPv\",\"click\",\"charge\",\"alipayInshopAmt\",\"alipayInshopNum\"],\"biz_code_in_list\":[\"onebpSite\"],\"offset\":0,\"page_size\":100,\"source\":\"baseReport\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：a7a953c4050b01b9e70b91b769a82ca8f773fd153fc011a33c26b02838a9d432



---

# 查询地域码表

`taobao.universalbp.new.commonapi.getcodeconfig`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| area_query_v_o | AreaQueryVO | 否 | 地域查询 | — |
| area_query_v_o.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_commonapi_getcodeconfig_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_commonapi_getcodeconfig_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_commonapi_getcodeconfig_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_commonapi_getcodeconfig_response.top_result.info.error_code |
| top_result.area_group_new_v_o | AreaGroupNewVO | 未标注 | 地域对象 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o |
| top_result.area_group_new_v_o.letter_groups | AreaNewVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups |
| top_result.area_group_new_v_o.letter_groups[].name | String | 未标注 | 对象名称 | xxxxx | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].name |
| top_result.area_group_new_v_o.letter_groups[].id | String | 未标注 | 对象标识 | xxxxx | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].id |
| top_result.area_group_new_v_o.letter_groups[].provinces | ProvincesVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces |
| top_result.area_group_new_v_o.letter_groups[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].name |
| top_result.area_group_new_v_o.letter_groups[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].id |
| top_result.area_group_new_v_o.letter_groups[].provinces[].cities | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].cities |
| top_result.area_group_new_v_o.letter_groups[].provinces[].cities[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].cities.region_v_o[].name |
| top_result.area_group_new_v_o.letter_groups[].provinces[].cities[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].cities.region_v_o[].id |
| top_result.area_group_new_v_o.letter_groups[].provinces[].provinces | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].provinces |
| top_result.area_group_new_v_o.letter_groups[].provinces[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].provinces.region_v_o[].name |
| top_result.area_group_new_v_o.letter_groups[].provinces[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.letter_groups.area_new_v_o[].provinces.provinces_v_o[].provinces.region_v_o[].id |
| top_result.area_group_new_v_o.location_groups | AreaNewVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups |
| top_result.area_group_new_v_o.location_groups[].name | String | 未标注 | 对象名称 | xxxxx | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].name |
| top_result.area_group_new_v_o.location_groups[].id | String | 未标注 | 对象标识 | xxxxx | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].id |
| top_result.area_group_new_v_o.location_groups[].provinces | ProvincesVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces |
| top_result.area_group_new_v_o.location_groups[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].name |
| top_result.area_group_new_v_o.location_groups[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].id |
| top_result.area_group_new_v_o.location_groups[].provinces[].cities | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].cities |
| top_result.area_group_new_v_o.location_groups[].provinces[].cities[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].cities.region_v_o[].name |
| top_result.area_group_new_v_o.location_groups[].provinces[].cities[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].cities.region_v_o[].id |
| top_result.area_group_new_v_o.location_groups[].provinces[].provinces | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].provinces |
| top_result.area_group_new_v_o.location_groups[].provinces[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].provinces.region_v_o[].name |
| top_result.area_group_new_v_o.location_groups[].provinces[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.location_groups.area_new_v_o[].provinces.provinces_v_o[].provinces.region_v_o[].id |
| top_result.area_group_new_v_o.last_provinces | ProvincesVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces |
| top_result.area_group_new_v_o.last_provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].name |
| top_result.area_group_new_v_o.last_provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].id |
| top_result.area_group_new_v_o.last_provinces[].cities | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].cities |
| top_result.area_group_new_v_o.last_provinces[].cities[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].cities.region_v_o[].name |
| top_result.area_group_new_v_o.last_provinces[].cities[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].cities.region_v_o[].id |
| top_result.area_group_new_v_o.last_provinces[].provinces | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].provinces |
| top_result.area_group_new_v_o.last_provinces[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].provinces.region_v_o[].name |
| top_result.area_group_new_v_o.last_provinces[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.last_provinces.provinces_v_o[].provinces.region_v_o[].id |
| top_result.area_group_new_v_o.overseas | ProvincesVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas |
| top_result.area_group_new_v_o.overseas[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].name |
| top_result.area_group_new_v_o.overseas[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].id |
| top_result.area_group_new_v_o.overseas[].cities | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].cities |
| top_result.area_group_new_v_o.overseas[].cities[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].cities.region_v_o[].name |
| top_result.area_group_new_v_o.overseas[].cities[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].cities.region_v_o[].id |
| top_result.area_group_new_v_o.overseas[].provinces | RegionVO [] | 未标注 | 业务集合 | — | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].provinces |
| top_result.area_group_new_v_o.overseas[].provinces[].name | String | 未标注 | 对象名称 | 测试 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].provinces.region_v_o[].name |
| top_result.area_group_new_v_o.overseas[].provinces[].id | Number | 未标注 | 对象标识 | 10 | universalbp_new_commonapi_getcodeconfig_response.top_result.area_group_new_v_o.overseas.provinces_v_o[].provinces.region_v_o[].id |

## 本站请求结构

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

```json

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

```

## 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.commonapi.getcodeconfig\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：823a9aa43519622efd227a853a42a5ba86a4ea0fc07b1644dd239ba66958a42a



---

# 基于dmp配置获取dmp人群

`taobao.universalbp.new.label.dmp.finddmpcrowdbymoduleconfig`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| dmp_crowd_module_config_query_v_o | DmpCrowdModuleConfigQueryVO | 是 | 人群查询对象 | — |
| dmp_crowd_module_config_query_v_o.app_id_list | Number [] | 否 | 标识集合 | [0,45,46,47,48,52,70,73,74,76,123,151] |
| dmp_crowd_module_config_query_v_o.deliver_app_id | Number | 否 | 业务对象标识 | 74 |
| dmp_crowd_module_config_query_v_o.int_current_page | Number | 否 | 业务字段 int_current_page | 1 |
| dmp_crowd_module_config_query_v_o.int_page_size | Number | 否 | 业务字段 int_page_size | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.info.error_code |
| top_result.dmp_crowd_v_o_top_bulk_data | TopBulkData | 未标注 | 人群对象 | — | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.dmp_crowd_v_o_top_bulk_data |
| top_result.dmp_crowd_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.dmp_crowd_v_o_top_bulk_data.count |
| top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list | DmpCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list |
| top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list[].dmp_crowd_id | Number | 未标注 | 人群标识 | 24664999 | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list.dmp_crowd_v_o[].dmp_crowd_id |
| top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 测试12 | universalbp_new_label_dmp_finddmpcrowdbymoduleconfig_response.top_result.dmp_crowd_v_o_top_bulk_data.dmp_crowd_v_o_list.dmp_crowd_v_o[].crowd_name |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.label.dmp.finddmpcrowdbymoduleconfig",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "dmp_crowd_module_config_query_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.label.dmp.finddmpcrowdbymoduleconfig\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"dmp_crowd_module_config_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：cd4e61bbf4571d347fb71f233b924911d1a40c1f41c633a8e3ddda99177b529a



---

# 查询dmp浮层配置

`taobao.universalbp.new.label.dmp.finddmpmoduleconfig`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.info.error_code |
| top_result.dmp_module_config_v_o | DmpModuleConfigVO | 未标注 | 业务对象 | — | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.dmp_module_config_v_o |
| top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list | DmpBaseOptionalSelectVO [] | 未标注 | 列表集合 | — | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list |
| top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list[].app_id_list | Number [] | 未标注 | 标识集合 | [0,45,46,47,48,52,70,73,74,76,123,151] | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list.dmp_base_optional_select_v_o[].app_id_list |
| top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list[].display_name | String | 未标注 | 业务字段 display_name | 所有来源 | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.dmp_module_config_v_o.dmp_base_optional_select_app_list.dmp_base_optional_select_v_o[].display_name |
| top_result.dmp_module_config_v_o.deliver_app_id | Number | 未标注 | 业务对象标识 | 74 | universalbp_new_label_dmp_finddmpmoduleconfig_response.top_result.dmp_module_config_v_o.deliver_app_id |

## 本站请求结构

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

```json

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

```

## 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.label.dmp.finddmpmoduleconfig\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：4a7b8cd41b314f9e905321c29f83ac35acbf2c1f1e8e746aacdf516776ae4f0f



---

# 查询可用标签id信息

`taobao.universalbp.new.label.findconfiglist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_label_findconfiglist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_label_findconfiglist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_label_findconfiglist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_label_findconfiglist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_label_findconfiglist_response.top_result.info.error_code |
| top_result.label_config_v_o_top_bulk_data | TopBulkData | 未标注 | 定向标签对象 | — | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data |
| top_result.label_config_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data.count |
| top_result.label_config_v_o_top_bulk_data.label_config_v_o_list | LabelConfigVO [] | 未标注 | 定向标签列表集合 | — | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data.label_config_v_o_list |
| top_result.label_config_v_o_top_bulk_data.label_config_v_o_list[].label_id | Number | 未标注 | 定向标签标识 | 3000505 | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data.label_config_v_o_list.label_config_v_o[].label_id |
| top_result.label_config_v_o_top_bulk_data.label_config_v_o_list[].label_group_name | String | 未标注 | 业务字段 label_group_name | 人群特征继承 | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data.label_config_v_o_list.label_config_v_o[].label_group_name |
| top_result.label_config_v_o_top_bulk_data.label_config_v_o_list[].business_type | String | 未标注 | 业务字段 business_type；枚举：extend=扩展人群、seed=种子人群 | seed | universalbp_new_label_findconfiglist_response.top_result.label_config_v_o_top_bulk_data.label_config_v_o_list.label_config_v_o[].business_type |

## 本站请求结构

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

```json

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

```

## 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.label.findconfiglist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：5ddcd82d5b0efc07323b76fb79b45c7286c1bc06de603448425e37c827d6f16d



---

# 查询无界版计划对应的原场景计划id

`taobao.universalbp.new.campaign.findsubcampaignid`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_id_v_o | CampaignIdVO | 是 | 计划标识 | — |
| campaign_id_v_o.campaign_id | Number | 是 | 推广计划编号 | 68796878069 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_findsubcampaignid_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_findsubcampaignid_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_findsubcampaignid_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_findsubcampaignid_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_findsubcampaignid_response.top_result.info.error_code |
| top_result.campaign_id_v_o | CampaignIdVO | 未标注 | 计划标识 | — | universalbp_new_campaign_findsubcampaignid_response.top_result.campaign_id_v_o |
| top_result.campaign_id_v_o.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_campaign_findsubcampaignid_response.top_result.campaign_id_v_o.campaign_id |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：c3cd9a3469c336f1846c2669980bf35e2829eb998e16de4b593fd0a4c4e16039



---

# 计划总诊断计划数

`taobao.universalbp.new.diagnose.highlight`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_diagnose_highlight_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_diagnose_highlight_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_diagnose_highlight_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_diagnose_highlight_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_diagnose_highlight_response.top_result.info.error_code |
| top_result.diagnose_highlight_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data |
| top_result.diagnose_highlight_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data.count |
| top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list | DiagnoseHighlightVO [] | 未标注 | 列表集合 | — | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list |
| top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list[].fault_code | String | 未标注 | 业务字段 fault_code | CAMPAIGN_FINISH | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list.diagnose_highlight_v_o[].fault_code |
| top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list[].num | Number | 未标注 | 业务字段 num | 377 | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list.diagnose_highlight_v_o[].num |
| top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list[].fault_name | String | 未标注 | 业务字段 fault_name | 投放中 | universalbp_new_diagnose_highlight_response.top_result.diagnose_highlight_v_o_top_bulk_data.diagnose_highlight_v_o_list.diagnose_highlight_v_o[].fault_name |

## 本站请求结构

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

```json

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

```

## 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.diagnose.highlight\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：a58f8930e75fa20a10f3ace8f84796bbe7f67ea2299fce3e14e5bac559e21ac2



---

# 账户花费数据汇总

`taobao.universalbp.new.report.chargesum`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| report_query_v_o | ReportQueryVO | 是 | 报表查询 | — |
| report_query_v_o.split_type | String | 否 | 统计拆分方式 | hour |
| report_query_v_o.unify_type | String | 否 | 转化归因口径 | zhai |
| report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-12 |
| report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [account, campaign] |
| report_query_v_o.query_field_in_list | String [] | 否 | 返回指标集合 | adPv |
| report_query_v_o.rpt_type | String | 否 | 业务字段 rpt_type | crowd |
| report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_chargesum_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_chargesum_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_chargesum_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_chargesum_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_chargesum_response.top_result.info.error_code |
| top_result.top_charge_sum_v_o | TopChargeSumVO | 未标注 | 业务对象 | — | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o |
| top_result.top_charge_sum_v_o.total_charge | String | 未标注 | 业务字段 total_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.total_charge |
| top_result.top_charge_sum_v_o.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.crowd_scene_charge |
| top_result.top_charge_sum_v_o.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.item_scene_charge |
| top_result.top_charge_sum_v_o.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.activity_scene_charge |
| top_result.top_charge_sum_v_o.display_charge | String | 未标注 | 业务字段 display_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.display_charge |
| top_result.top_charge_sum_v_o.search_charge | String | 未标注 | 业务字段 search_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.search_charge |
| top_result.top_charge_sum_v_o.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.content_scene_charge |
| top_result.top_charge_sum_v_o.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.shop_scene_charge |
| top_result.top_charge_sum_v_o.multi_aim_scene_charge | String | 未标注 | 业务字段 multi_aim_scene_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.multi_aim_scene_charge |
| top_result.top_charge_sum_v_o.onebp_site_charge | String | 未标注 | 业务字段 onebp_site_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.onebp_site_charge |
| top_result.top_charge_sum_v_o.ybq_gift_charge | String | 未标注 | 业务字段 ybq_gift_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.ybq_gift_charge |
| top_result.top_charge_sum_v_o.guarantee_pack_charge | String | 未标注 | 业务字段 guarantee_pack_charge | 2690.00 | universalbp_new_report_chargesum_response.top_result.top_charge_sum_v_o.guarantee_pack_charge |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.chargesum",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "report_query_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.report.chargesum\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：b2dd6a758aee41be3349778ff7377877e0bc275fc200a582936d0852649c50a5



---

# 获取下载链接

`taobao.universalbp.new.report.async.download.get.url`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| async_rpt_query_v_o | AsyncRptQueryVO | 是 | 查询对象 | — |
| async_rpt_query_v_o.task_id | Number | 否 | 业务对象标识 | 3 |
| async_rpt_query_v_o.start_time | String | 是 | 查询或投放起始时间 | xxxxx |
| async_rpt_query_v_o.end_time | String | 是 | 查询或投放结束时间 | xxxxx |
| async_rpt_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| async_rpt_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_async_download_get_url_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_async_download_get_url_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_async_download_get_url_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_async_download_get_url_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_async_download_get_url_response.top_result.info.error_code |
| top_result.top_async_rpt_v_o | TopAsyncRptVO | 未标注 | 业务对象 | — | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o |
| top_result.top_async_rpt_v_o.task_id | Number | 未标注 | 业务对象标识 | 1111 | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.task_id |
| top_result.top_async_rpt_v_o.biz_code | String | 未标注 | 推广场景标识 | bizCode | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.biz_code |
| top_result.top_async_rpt_v_o.file_name | String | 未标注 | 业务字段 file_name | 账户报表001 | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.file_name |
| top_result.top_async_rpt_v_o.status | String | 未标注 | 状态标识 | SUCCESS-生成成功， FAIL-生成失败（由于参数设置例如超过时间长度限度会生成失败 | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.status |
| top_result.top_async_rpt_v_o.gmt_create | Date | 未标注 | 业务字段 gmt_create | 2023-06-13 | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.gmt_create |
| top_result.top_async_rpt_v_o.gmt_modified | Date | 未标注 | 业务字段 gmt_modified | 2023-06-13 | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.gmt_modified |
| top_result.top_async_rpt_v_o.download_url | String | 未标注 | 业务字段 download_url | http: | universalbp_new_report_async_download_get_url_response.top_result.top_async_rpt_v_o.download_url |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.async.download.get.url",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "async_rpt_query_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.report.async.download.get.url\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"async_rpt_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：70225bdbb80d312f02bf6de7ce3d13931397d6b26c2dbdbb576977908ebd92f1



---

# 查询异步下载任务列表

`taobao.universalbp.new.report.async.download.find.task.page`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| async_rpt_query_v_o | AsyncRptQueryVO | 是 | 查询对象 | — |
| async_rpt_query_v_o.task_id | Number | 否 | 业务对象标识 | 3 |
| async_rpt_query_v_o.start_time | String | 是 | 查询或投放起始时间 | xxxxx |
| async_rpt_query_v_o.end_time | String | 是 | 查询或投放结束时间 | xxxxx |
| async_rpt_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| async_rpt_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_async_download_find_task_page_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_async_download_find_task_page_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_async_download_find_task_page_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_async_download_find_task_page_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_async_download_find_task_page_response.top_result.info.error_code |
| top_result.top_async_rpt_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data |
| top_result.top_async_rpt_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.count |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list | TopAsyncRptVO [] | 未标注 | 列表集合 | — | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].task_id | Number | 未标注 | 业务对象标识 | 1111 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].task_id |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | bizCode | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].biz_code |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].file_name | String | 未标注 | 业务字段 file_name | 账户报表001 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].file_name |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].status | String | 未标注 | 状态标识 | SUCCESS-生成成功， FAIL-生成失败（由于参数设置例如超过时间长度限度会生成失败 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].status |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].gmt_create | Date | 未标注 | 业务字段 gmt_create | 2023-06-13 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].gmt_create |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].gmt_modified | Date | 未标注 | 业务字段 gmt_modified | 2023-06-13 | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].gmt_modified |
| top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list[].download_url | String | 未标注 | 业务字段 download_url | http: | universalbp_new_report_async_download_find_task_page_response.top_result.top_async_rpt_v_o_top_bulk_data.top_async_rpt_v_o_list.top_async_rpt_v_o[].download_url |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.async.download.find.task.page",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "async_rpt_query_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.report.async.download.find.task.page\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"async_rpt_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：ea1c2038a533f2c14a8d64525a71784465a13b5d1bc640a65094096a0b6c1174



---

# 创建异步下载任务

`taobao.universalbp.new.report.async.create.download.task`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| report_query_v_o | ReportQueryVO | 是 | 报表查询 | — |
| report_query_v_o.from_real_time | Boolean | 否 | 业务字段 from_real_time | false |
| report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| report_query_v_o.source | String | 否 | 请求来源标识 | async_dowdload |
| report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| report_query_v_o.strategy_adgroup_id_or_name | String | 否 | 业务字段 strategy_adgroup_id_or_name | 连衣裙长裙 |
| report_query_v_o.strategy_adgroup_id_in_list | Number [] | 否 | 单元标识集合 | [68798644117] |
| report_query_v_o.sub_promotion_types | String [] | 否 | 业务字段 sub_promotion_types | [USER_DEFINE_URL] |
| report_query_v_o.strategy_target_title_like | String | 否 | 业务字段 strategy_target_title_like | 消费 |
| report_query_v_o.item_ids | Number [] | 否 | 业务字段 item_ids | [68798644117] |
| report_query_v_o.strategy_creative_id_or_name | String | 否 | 业务字段 strategy_creative_id_or_name | 1111111 |
| report_query_v_o.adzone_pkg_id_in_list | Number [] | 否 | 标识集合 | [68798644117] |
| report_query_v_o.bid_word_type_in_list | String [] | 否 | 出价词类型集合 | [word, wordPkg] |
| report_query_v_o.strategy_bidword_name_like | String | 否 | 业务字段 strategy_bidword_name_like | 红裙 |
| report_query_v_o.strategy_bidword_pkg_name_like | String | 否 | 业务字段 strategy_bidword_pkg_name_like | 红裙 |
| report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | [account, campaign] |
| report_query_v_o.query_field_in_list | String [] | 否 | 返回指标集合 | adPv |
| report_query_v_o.excel_name | String | 是 | 业务字段 excel_name；下载时必填 | 账户报表00000 |
| report_query_v_o.field_type | String | 是 | 字段类型 | xxxxx |
| report_query_v_o.rpt_type | String | 否 | 业务字段 rpt_type | crowd |
| report_query_v_o.parent_adc_name | String | 是 | 业务字段 parent_adc_name | report_frame_campaign |
| report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_async_create_download_task_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_async_create_download_task_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_async_create_download_task_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_async_create_download_task_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_async_create_download_task_response.top_result.info.error_code |
| top_result.top_report_download_v_o | TopReportDownloadVO | 未标注 | 报表对象 | — | universalbp_new_report_async_create_download_task_response.top_result.top_report_download_v_o |
| top_result.top_report_download_v_o.task_id | Number | 未标注 | 业务对象标识 | 99999 | universalbp_new_report_async_create_download_task_response.top_result.top_report_download_v_o.task_id |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.async.create.download.task",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "report_query_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.report.async.create.download.task\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"report_query_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 表示业务未完成。

来源校验 SHA256：07178a0a3b496e6042d06e08465b37c888ef5b02d49eef76dcb94f851c917ea9



---

# 查询单元故障信息

`taobao.universalbp.new.diagnose.adgroup.faultlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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_id_list_v_o | AdgroupIdListVO | 是 | 单元标识列表 | — |
| adgroup_id_list_v_o.adgroup_id_list | Number [] | 是 | 单元标识列表 | [68793666608] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_diagnose_adgroup_faultlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_diagnose_adgroup_faultlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_diagnose_adgroup_faultlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_diagnose_adgroup_faultlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_diagnose_adgroup_faultlist_response.top_result.info.error_code |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data | TopBulkData | 未标注 | 单元对象 | — | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.count |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list | AdgroupSimpleDiagnoseInfoVO [] | 未标注 | 单元列表集合 | — | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].adgroup_id |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].fault_info | DiagnoseSimpleFaultInfoVO [] | 未标注 | 业务集合 | — | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].fault_info |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].fault_info[].fault_code | String | 未标注 | 业务字段 fault_code | CAMPAIGN_BUDGET_INSUFFICIENCY | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].fault_code |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].fault_info[].title | String | 未标注 | 展示标题 | 预算即将撞线 | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].title |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].fault_info[].text | String | 未标注 | 业务字段 text | 今日预算即将消耗完毕，可补充预算保障拿量充分 | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].text |
| top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list[].fault_info[].level | String | 未标注 | 业务字段 level | yellow | universalbp_new_diagnose_adgroup_faultlist_response.top_result.adgroup_simple_diagnose_info_v_o_top_bulk_data.adgroup_simple_diagnose_info_v_o_list.adgroup_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].level |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.diagnose.adgroup.faultlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adgroup_id_list_v_o": {}
  }
}

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：34b5dbc9b26d1b38c43efcd15c29963e8c645d0dce50ef721912ce967d113f85



---

# 查询计划故障信息

`taobao.universalbp.new.diagnose.campaign.faultlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_id_list_v_o | CampaignIdListVO | 是 | 计划标识列表 | — |
| campaign_id_list_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68796878069] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_diagnose_campaign_faultlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_diagnose_campaign_faultlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_diagnose_campaign_faultlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_diagnose_campaign_faultlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_diagnose_campaign_faultlist_response.top_result.info.error_code |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data | TopBulkData | 未标注 | 计划对象 | — | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.count |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list | CampaignSimpleDiagnoseInfoVO [] | 未标注 | 计划列表集合 | — | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].campaign_id |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].fault_info | DiagnoseSimpleFaultInfoVO [] | 未标注 | 业务集合 | — | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].fault_info |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].fault_info[].fault_code | String | 未标注 | 业务字段 fault_code | CAMPAIGN_BUDGET_INSUFFICIENCY | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].fault_code |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].fault_info[].title | String | 未标注 | 展示标题 | 预算即将撞线 | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].title |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].fault_info[].text | String | 未标注 | 业务字段 text | 今日预算即将消耗完毕，可补充预算保障拿量充分 | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].text |
| top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list[].fault_info[].level | String | 未标注 | 业务字段 level | yellow | universalbp_new_diagnose_campaign_faultlist_response.top_result.campaign_simple_diagnose_info_v_o_top_bulk_data.campaign_simple_diagnose_info_v_o_list.campaign_simple_diagnose_info_v_o[].fault_info.diagnose_simple_fault_info_v_o[].level |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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 表示业务未完成。

来源校验 SHA256：fc3f700971d96c35ce92700342dc46ef250b947559087db24574845546570417



---

# 批量获取出价建议

`taobao.universalbp.new.algo.getbatchbidsuggestion`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| algo_query_list_v_o | AlgoQueryListVO | 是 | 查询列表对象 | — |
| algo_query_list_v_o.algo_query_list | AlgoQueryVO [] | 否 | 查询列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign | AlgoCampaignQueryVO | 否 | 计划 | — |
| algo_query_list_v_o.algo_query_list[].campaign.campaign_id | Number | 否 | 推广计划编号 | 68799007001 |
| algo_query_list_v_o.algo_query_list[].campaign.promotion_model | String | 否 | 业务字段 promotion_model | display |
| algo_query_list_v_o.algo_query_list[].campaign.promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| algo_query_list_v_o.algo_query_list[].campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy | new_ad_similar |
| algo_query_list_v_o.algo_query_list[].campaign.promotion_goals | String | 否 | 业务字段 promotion_goals | shop_crowd |
| algo_query_list_v_o.algo_query_list[].campaign.optimize_target | String | 否 | 优化目标 | shop_visit_new |
| algo_query_list_v_o.algo_query_list[].campaign.dmc_type | String | 否 | 预算方式标识 | normal |
| algo_query_list_v_o.algo_query_list[].campaign.day_budget | Number | 否 | 日预算 | 60 |
| algo_query_list_v_o.algo_query_list[].campaign.reap_all_budget | Number | 否 | 业务字段 reap_all_budget | 60 |
| algo_query_list_v_o.algo_query_list[].campaign.old_budget | Number | 否 | 业务字段 old_budget | 500 |
| algo_query_list_v_o.algo_query_list[].campaign.total_budget | Number | 否 | 累计预算 | 350 |
| algo_query_list_v_o.algo_query_list[].campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| algo_query_list_v_o.algo_query_list[].campaign.budget_period | Number | 否 | 业务字段 budget_period | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.bid_type | String | 否 | 出价类型 | roi_control |
| algo_query_list_v_o.algo_query_list[].campaign.constraint_type | String | 否 | 业务字段 constraint_type | roi |
| algo_query_list_v_o.algo_query_list[].campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| algo_query_list_v_o.algo_query_list[].campaign.old_constraint_value | String | 否 | 业务字段 old_constraint_value | 2.5 |
| algo_query_list_v_o.algo_query_list[].campaign.promotion_type | String | 否 | 业务字段 promotion_type | item |
| algo_query_list_v_o.algo_query_list[].campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode | user_define |
| algo_query_list_v_o.algo_query_list[].campaign.item_rec_strategy | String [] | 否 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
| algo_query_list_v_o.algo_query_list[].campaign.is_quick_lift | Boolean | 否 | 业务字段 is_quick_lift | true |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| algo_query_list_v_o.algo_query_list[].campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| algo_query_list_v_o.algo_query_list[].campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_list_v_o.algo_query_list[].campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| algo_query_list_v_o.algo_query_list[].campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| algo_query_list_v_o.algo_query_list[].campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| algo_query_list_v_o.algo_query_list[].campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| algo_query_list_v_o.algo_query_list[].campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| algo_query_list_v_o.algo_query_list[].campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| algo_query_list_v_o.algo_query_list[].campaign.word_list | WordCommandVO [] | 否 | 词列表 | — |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].word | String | 否 | 词 | 鞋原创小众 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| algo_query_list_v_o.algo_query_list[].campaign.search_upgrade_pxb | Number | 否 | 业务字段 search_upgrade_pxb | 0 |
| algo_query_list_v_o.algo_query_list[].campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | {} |
| algo_query_list_v_o.algo_query_list[].campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| algo_query_list_v_o.algo_query_list[].campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| algo_query_list_v_o.algo_query_list[].campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| algo_query_list_v_o.algo_query_list[].campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| algo_query_list_v_o.algo_query_list[].campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| algo_query_list_v_o.algo_query_list[].campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| algo_query_list_v_o.algo_query_list[].campaign.is_multi_target | Boolean | 否 | 业务字段 is_multi_target | true |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| algo_query_list_v_o.algo_query_list[].campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| algo_query_list_v_o.algo_query_list[].adgroup_list | AlgoAdgroupQueryVO [] | 否 | 单元列表 | — |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| algo_query_list_v_o.algo_query_list[].adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| algo_query_list_v_o.algo_query_list[].effect_type_list | String [] | 否 | 类型集合 | ["gmv"] |
| algo_query_list_v_o.algo_query_list[].dmc_type_element | String | 否 | 业务字段 dmc_type_element | dayBudget |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_algo_getbatchbidsuggestion_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_algo_getbatchbidsuggestion_response.top_result.info.error_code |
| top_result.bid_suggest_v_o_top_part_data | TopPartData | 未标注 | 出价建议对象 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data |
| top_result.bid_suggest_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.count |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list | BidSuggestVO [] | 未标注 | 出价建议列表 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].campaign_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_min | String | 未标注 | 出价最小 | 4.17 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_min |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_max | String | 未标注 | 出价最大 | 16.66 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_max |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_left | String | 未标注 | 业务字段 bid_left | 6.66 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_left |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle | String | 未标注 | 业务字段 bid_middle | 8.33 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_right | String | 未标注 | 业务字段 bid_right | 9.66 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_right |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.10 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].validate_bid_min |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 10.00 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].validate_bid_max |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_suggest_discount_list | AdzoneSuggestDiscountVO [] | 未标注 | 建议列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_suggest_discount_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_suggest_discount_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850197 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_suggest_discount_list.adzone_suggest_discount_v_o[].adzone_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_suggest_discount_list[].suggest_discount | Number | 未标注 | 业务字段 suggest_discount | 35 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_suggest_discount_list.adzone_suggest_discount_v_o[].suggest_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list | AdzoneRefVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].adzone_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].adzone_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].min_discount | Number | 未标注 | 业务字段 min_discount | 1 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].min_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].max_discount | Number | 未标注 | 业务字段 max_discount | 30 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].max_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].campaign_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].campaign_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].bid_type |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].discount | Number | 未标注 | 出价溢价 | 0 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].fit_discount | Number | 未标注 | 业务字段 fit_discount | 0 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].fit_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].status | String | 未标注 | 状态标识；枚举：start=投放、pause=暂停 | start | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].status |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list | OperationVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].operation_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list[].code | String | 未标注 | 结果或业务代码 | 12 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].code |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list[].name | String | 未标注 | 对象名称 | 操作 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list[].tips | String | 未标注 | 业务字段 tips | xxxx | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].tips |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list[].disabled | Boolean | 未标注 | 业务字段 disabled | false | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].disabled |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].operation_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].adzone_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list | CrowdSuggestPriceVO [] | 未标注 | 人群建议金额列表 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list[].target_type | Number | 未标注 | 目标类型 | 100 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list.crowd_suggest_price_v_o[].target_type |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list[].option_value | String | 未标注 | 业务字段 option_value | 31536383 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list.crowd_suggest_price_v_o[].option_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list[].price_upper | String | 未标注 | 业务字段 price_upper | 0.71 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list.crowd_suggest_price_v_o[].price_upper |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list[].price_lower | String | 未标注 | 业务字段 price_lower | 0.48 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list.crowd_suggest_price_v_o[].price_lower |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_suggest_price_list[].price_middle | String | 未标注 | 业务字段 price_middle | 0.60 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_suggest_price_list.crowd_suggest_price_v_o[].price_middle |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list | CrowdRefVO [] | 未标注 | 人群列表 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].campaign_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].adgroup_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].online_status |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.target_type |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.average_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.min_fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.max_fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_min |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_max |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.peer_avg_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.average_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.min_fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.max_fit_bid_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.validate_bid_min |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.validate_bid_max |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.fit_discount |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].crowd_list.crowd_ref_v_o[].price.peer_avg_price |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].crowd_list[].report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect | EffectPredictVO | 未标注 | 出价对象 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.pv | Number | 未标注 | 业务字段 pv | 1621 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.pv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.pv_low | Number | 未标注 | 业务字段 pv_low | 1297 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.pv_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.pv_high | Number | 未标注 | 业务字段 pv_high | 1945 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.pv_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.click | Number | 未标注 | 点击次数 | 97 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.click |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.click_low | Number | 未标注 | 业务字段 click_low | 78 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.click_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.click_high | Number | 未标注 | 业务字段 click_high | 117 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.click_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.conv | Number | 未标注 | 业务字段 conv | 13 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.conv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.conv_low | Number | 未标注 | 业务字段 conv_low | 10 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.conv_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.conv_high | Number | 未标注 | 业务字段 conv_high | 15 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.conv_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.wconv | Number | 未标注 | 业务字段 wconv | 27 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.wconv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.wconv_low | Number | 未标注 | 业务字段 wconv_low | 22 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.wconv_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.wconv_high | Number | 未标注 | 业务字段 wconv_high | 33 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.wconv_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.mem | Number | 未标注 | 业务字段 mem | 0 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.mem |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.mem_low | Number | 未标注 | 业务字段 mem_low | 0 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.mem_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.mem_high | Number | 未标注 | 业务字段 mem_high | 1 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.mem_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cost | String | 未标注 | 业务字段 cost；计量单位：元 | 823.83 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cost |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cost_low | String | 未标注 | 业务字段 cost_low；计量单位：元 | 659.06 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cost_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cost_high | String | 未标注 | 业务字段 cost_high；计量单位：元 | 988.60 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cost_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cart | Number | 未标注 | 业务字段 cart | 10 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cart |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cart_low | Number | 未标注 | 业务字段 cart_low | 5 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cart_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.cart_high | Number | 未标注 | 业务字段 cart_high | 15 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.cart_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.uv_aim_low | Number | 未标注 | 业务字段 uv_aim_low | 5 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.uv_aim_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.uv_aim_high | Number | 未标注 | 业务字段 uv_aim_high | 15 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.uv_aim_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv | String | 未标注 | 业务字段 gmv | 6845.21 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_net | String | 未标注 | 业务字段 gmv_net | 6845.21 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_net |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_low | String | 未标注 | 业务字段 gmv_low | 5476.17 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_high | String | 未标注 | 业务字段 gmv_high | 8214.26 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_low_net | String | 未标注 | 业务字段 gmv_low_net | 5476.17 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_low_net |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_high_net | String | 未标注 | 业务字段 gmv_high_net | 8214.26 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_high_net |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.min_gmv | String | 未标注 | 业务字段 min_gmv | 5476.17 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.min_gmv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.max_gmv | String | 未标注 | 业务字段 max_gmv | 8214.26 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.max_gmv |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.success_ratio_high | String | 未标注 | 业务字段 success_ratio_high | 0.9 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.success_ratio_high |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.success_ratio_low | String | 未标注 | 业务字段 success_ratio_low | 0.8 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.success_ratio_low |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.gmv_diff_percent | String | 未标注 | 业务字段 gmv_diff_percent | 0.67 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.gmv_diff_percent |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.effect_predict_reason | String | 未标注 | 业务字段 effect_predict_reason | 预计曝光量<span number=\"highlight\">+20%</span>，自然流量助推<span number=\"error\">+10%</span> | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.effect_predict_reason |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_middle_effect.reason | String | 未标注 | 业务字段 reason | 预计可获得点击量2次 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_middle_effect.reason |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_rec_reason | String | 未标注 | 业务字段 bid_rec_reason | 商品昨日搜索点击量低于2，同行同层平均目标投产比为5.84，建议投产比设置不超过10.31，获取更多点击。大促期建议考虑确收因素，设置更合理的ROI。 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_rec_reason |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list | BidInfoVO [] | 未标注 | 出价列表集合 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list[].value | String | 未标注 | 值 | 1.92 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list.bid_info_v_o[].value |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list[].tag | String | 未标注 | 业务字段 tag | 性价比推荐 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list.bid_info_v_o[].tag |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list[].is_default | Boolean | 未标注 | 业务字段 is_default | false | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list.bid_info_v_o[].is_default |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list[].tag_mode | String | 未标注 | 业务字段 tag_mode | AI小万 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list.bid_info_v_o[].tag_mode |
| top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list[].bid_info_list[].reason | String | 未标注 | 业务字段 reason | 采纳后预计可获得点击量提出7% | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.bid_suggest_v_o_list.bid_suggest_v_o[].bid_info_list.bid_info_v_o[].reason |
| top_result.bid_suggest_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.error_count |
| top_result.bid_suggest_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.error_details |
| top_result.bid_suggest_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.bid_suggest_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.error_details.top_fail_result[].msg |

## 核对备注

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

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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.bid_suggest_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_algo_getbatchbidsuggestion_response.top_result.bid_suggest_v_o_top_part_data.error_details）

来源校验 SHA256：9e2171d81700bdcb76840c076a300ffc7c520c8f143001908a66968d27fcdccc



---

# 是否已升级UC Schema

`taobao.universalbp.new.check.complete.scene`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_check_complete_scene_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_check_complete_scene_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_check_complete_scene_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_check_complete_scene_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_check_complete_scene_response.top_result.info.error_code |
| top_result.complete_wxt_scene_mig_check_v_o | CompleteWxtSceneMigCheckVO | 未标注 | 业务对象 | — | universalbp_new_check_complete_scene_response.top_result.complete_wxt_scene_mig_check_v_o |
| top_result.complete_wxt_scene_mig_check_v_o.has_complete_wxt_scene_mig | Boolean | 未标注 | 业务字段 has_complete_wxt_scene_mig | true | universalbp_new_check_complete_scene_response.top_result.complete_wxt_scene_mig_check_v_o.has_complete_wxt_scene_mig |
| top_result.complete_wxt_scene_mig_check_v_o.has_complete_ad_strategy_yu_re_u_c | Boolean | 未标注 | 业务字段 has_complete_ad_strategy_yu_re_u_c | true | universalbp_new_check_complete_scene_response.top_result.complete_wxt_scene_mig_check_v_o.has_complete_ad_strategy_yu_re_u_c |

## 本站请求结构

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

```json

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

```

## 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.check.complete.scene\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：5f7ab53f3e17408d91436ab82e96692c060adc7f8132c29a156b68e6c385e1c0



---

# 预算预估

`taobao.universalbp.new.algo.getbudgetsuggestion`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| algo_query_v_o | AlgoQueryVO | 是 | 查询对象 | — |
| algo_query_v_o.campaign | AlgoCampaignQueryVO | 否 | 计划 | — |
| algo_query_v_o.campaign.campaign_id | Number | 否 | 推广计划编号 | 68799007001 |
| algo_query_v_o.campaign.promotion_model | String | 否 | 业务字段 promotion_model | display |
| algo_query_v_o.campaign.promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| algo_query_v_o.campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy | new_ad_similar |
| algo_query_v_o.campaign.promotion_goals | String | 否 | 业务字段 promotion_goals | shop_crowd |
| algo_query_v_o.campaign.optimize_target | String | 否 | 优化目标 | shop_visit_new |
| algo_query_v_o.campaign.dmc_type | String | 否 | 预算方式标识 | normal |
| algo_query_v_o.campaign.day_budget | Number | 否 | 日预算 | 60 |
| algo_query_v_o.campaign.reap_all_budget | Number | 否 | 业务字段 reap_all_budget | 60 |
| algo_query_v_o.campaign.old_budget | Number | 否 | 业务字段 old_budget | 500 |
| algo_query_v_o.campaign.total_budget | Number | 否 | 累计预算 | 350 |
| algo_query_v_o.campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| algo_query_v_o.campaign.budget_period | Number | 否 | 业务字段 budget_period | 1 |
| algo_query_v_o.campaign.bid_type | String | 否 | 出价类型 | roi_control |
| algo_query_v_o.campaign.constraint_type | String | 否 | 业务字段 constraint_type | roi |
| algo_query_v_o.campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| algo_query_v_o.campaign.old_constraint_value | String | 否 | 业务字段 old_constraint_value | 2.5 |
| algo_query_v_o.campaign.promotion_type | String | 否 | 业务字段 promotion_type | item |
| algo_query_v_o.campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode | user_define |
| algo_query_v_o.campaign.item_rec_strategy | String [] | 否 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
| algo_query_v_o.campaign.is_quick_lift | Boolean | 否 | 业务字段 is_quick_lift | true |
| algo_query_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| algo_query_v_o.campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| algo_query_v_o.campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| algo_query_v_o.campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| algo_query_v_o.campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| algo_query_v_o.campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| algo_query_v_o.campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| algo_query_v_o.campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| algo_query_v_o.campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| algo_query_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| algo_query_v_o.campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| algo_query_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| algo_query_v_o.campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| algo_query_v_o.campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| algo_query_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| algo_query_v_o.campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| algo_query_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| algo_query_v_o.campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| algo_query_v_o.campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| algo_query_v_o.campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| algo_query_v_o.campaign.word_list | WordCommandVO [] | 否 | 词列表 | — |
| algo_query_v_o.campaign.word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| algo_query_v_o.campaign.word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| algo_query_v_o.campaign.word_list[].word | String | 否 | 词 | 鞋原创小众 |
| algo_query_v_o.campaign.word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| algo_query_v_o.campaign.word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| algo_query_v_o.campaign.word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| algo_query_v_o.campaign.word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| algo_query_v_o.campaign.search_upgrade_pxb | Number | 否 | 业务字段 search_upgrade_pxb | 0 |
| algo_query_v_o.campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| algo_query_v_o.campaign.algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | {} |
| algo_query_v_o.campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| algo_query_v_o.campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| algo_query_v_o.campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| algo_query_v_o.campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| algo_query_v_o.campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| algo_query_v_o.campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| algo_query_v_o.campaign.is_multi_target | Boolean | 否 | 业务字段 is_multi_target | true |
| algo_query_v_o.campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| algo_query_v_o.campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| algo_query_v_o.adgroup_list | AlgoAdgroupQueryVO [] | 否 | 单元列表 | — |
| algo_query_v_o.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| algo_query_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| algo_query_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| algo_query_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| algo_query_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 |
| algo_query_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| algo_query_v_o.effect_type_list | String [] | 否 | 类型集合 | ["gmv"] |
| algo_query_v_o.dmc_type_element | String | 否 | 业务字段 dmc_type_element | dayBudget |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_algo_getbudgetsuggestion_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_algo_getbudgetsuggestion_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_algo_getbudgetsuggestion_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_algo_getbudgetsuggestion_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_algo_getbudgetsuggestion_response.top_result.info.error_code |
| top_result.budget_suggest_v_o | BudgetSuggestVO | 未标注 | 预算建议 | — | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o |
| top_result.budget_suggest_v_o.budget_left | Number | 未标注 | 业务字段 budget_left | 200 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_left |
| top_result.budget_suggest_v_o.budget_middle | Number | 未标注 | 业务字段 budget_middle | 220 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_middle |
| top_result.budget_suggest_v_o.budget_right | Number | 未标注 | 业务字段 budget_right | 260 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_right |
| top_result.budget_suggest_v_o.budget_upper | Number | 未标注 | 业务字段 budget_upper | 260 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_upper |
| top_result.budget_suggest_v_o.budget_lower | Number | 未标注 | 业务字段 budget_lower | 200 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_lower |
| top_result.budget_suggest_v_o.algo_budget | Number | 未标注 | 业务字段 algo_budget | 220 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.algo_budget |
| top_result.budget_suggest_v_o.reason | String | 未标注 | 业务字段 reason | 根据同类目投放情况，建议每日预算不低于<span class='font-number bold color-3'>200</span>元 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.reason |
| top_result.budget_suggest_v_o.budget_default | Number | 未标注 | 业务字段 budget_default | 200 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_default |
| top_result.budget_suggest_v_o.budget_min | Number | 未标注 | 预算最小 | 100 | universalbp_new_algo_getbudgetsuggestion_response.top_result.budget_suggest_v_o.budget_min |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.algo.getbudgetsuggestion",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "algo_query_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.algo.getbudgetsuggestion\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"algo_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：bebf649b1fc06b42042d42e42ba03b9ba1fe509bf88609135e755391f2271c29



---

# 计划互斥判断

`taobao.universalbp.new.campaign.site.itemdiff`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| solution_command_list_v_o | SolutionCommandListVO | 是 | 操作列表对象 | — |
| solution_command_list_v_o.solution_list | SolutionCommandVO [] | 是 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list | AdgroupCommandVO [] | 是 | 单元列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_site_itemdiff_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_site_itemdiff_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_site_itemdiff_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_site_itemdiff_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_site_itemdiff_response.top_result.info.error_code |
| top_result.top_part_data | TopPartData | 未标注 | 业务对象 | — | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data |
| top_result.top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.count |
| top_result.top_part_data.data_list | Number [] | 未标注 | 业务条件集合 | 5,3 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.data_list |
| top_result.top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_count |
| top_result.top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details |
| top_result.top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].code |
| top_result.top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].msg |
| top_result.top_part_data.error_details[].result | CampaignVO | 未标注 | 执行结果内容 | — | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].result |
| top_result.top_part_data.error_details[].result.biz_code | String | 未标注 | 推广场景标识 | onebpSearch | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].result.biz_code |
| top_result.top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].result.campaign_id |
| top_result.top_part_data.error_details[].result.campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].result.campaign_name |
| top_result.top_part_data.error_details[].result.item_id | Number | 未标注 | 商品编号 | 806671599436 | universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details.top_fail_result[].result.item_id |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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.top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_site_itemdiff_response.top_result.top_part_data.error_details）

来源校验 SHA256：810ac2baeb6a4c0b7013bb779e470a1f59c574736b094754b51f346f84cd89a9



---

# 成效预估

`taobao.universalbp.new.algo.geteffectprediction`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| algo_query_v_o | AlgoQueryVO | 是 | 查询对象 | — |
| algo_query_v_o.campaign | AlgoCampaignQueryVO | 否 | 计划 | — |
| algo_query_v_o.campaign.campaign_id | Number | 否 | 推广计划编号 | 68799007001 |
| algo_query_v_o.campaign.promotion_model | String | 否 | 业务字段 promotion_model | display |
| algo_query_v_o.campaign.promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| algo_query_v_o.campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy | new_ad_similar |
| algo_query_v_o.campaign.promotion_goals | String | 否 | 业务字段 promotion_goals | shop_crowd |
| algo_query_v_o.campaign.optimize_target | String | 否 | 优化目标 | shop_visit_new |
| algo_query_v_o.campaign.dmc_type | String | 否 | 预算方式标识 | normal |
| algo_query_v_o.campaign.day_budget | Number | 否 | 日预算 | 60 |
| algo_query_v_o.campaign.reap_all_budget | Number | 否 | 业务字段 reap_all_budget | 60 |
| algo_query_v_o.campaign.old_budget | Number | 否 | 业务字段 old_budget | 500 |
| algo_query_v_o.campaign.total_budget | Number | 否 | 累计预算 | 350 |
| algo_query_v_o.campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| algo_query_v_o.campaign.budget_period | Number | 否 | 业务字段 budget_period | 1 |
| algo_query_v_o.campaign.bid_type | String | 否 | 出价类型 | roi_control |
| algo_query_v_o.campaign.constraint_type | String | 否 | 业务字段 constraint_type | roi |
| algo_query_v_o.campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| algo_query_v_o.campaign.old_constraint_value | String | 否 | 业务字段 old_constraint_value | 2.5 |
| algo_query_v_o.campaign.promotion_type | String | 否 | 业务字段 promotion_type | item |
| algo_query_v_o.campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode | user_define |
| algo_query_v_o.campaign.item_rec_strategy | String [] | 否 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
| algo_query_v_o.campaign.is_quick_lift | Boolean | 否 | 业务字段 is_quick_lift | true |
| algo_query_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| algo_query_v_o.campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| algo_query_v_o.campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| algo_query_v_o.campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| algo_query_v_o.campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| algo_query_v_o.campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| algo_query_v_o.campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| algo_query_v_o.campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| algo_query_v_o.campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| algo_query_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| algo_query_v_o.campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| algo_query_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| algo_query_v_o.campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| algo_query_v_o.campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| algo_query_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| algo_query_v_o.campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| algo_query_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| algo_query_v_o.campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| algo_query_v_o.campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| algo_query_v_o.campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| algo_query_v_o.campaign.word_list | WordCommandVO [] | 否 | 词列表 | — |
| algo_query_v_o.campaign.word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| algo_query_v_o.campaign.word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| algo_query_v_o.campaign.word_list[].word | String | 否 | 词 | 鞋原创小众 |
| algo_query_v_o.campaign.word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| algo_query_v_o.campaign.word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| algo_query_v_o.campaign.word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| algo_query_v_o.campaign.word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| algo_query_v_o.campaign.search_upgrade_pxb | Number | 否 | 业务字段 search_upgrade_pxb | 0 |
| algo_query_v_o.campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| algo_query_v_o.campaign.algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | {} |
| algo_query_v_o.campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| algo_query_v_o.campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| algo_query_v_o.campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| algo_query_v_o.campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| algo_query_v_o.campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| algo_query_v_o.campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| algo_query_v_o.campaign.is_multi_target | Boolean | 否 | 业务字段 is_multi_target | true |
| algo_query_v_o.campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| algo_query_v_o.campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| algo_query_v_o.adgroup_list | AlgoAdgroupQueryVO [] | 否 | 单元列表 | — |
| algo_query_v_o.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| algo_query_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| algo_query_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| algo_query_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| algo_query_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 |
| algo_query_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| algo_query_v_o.effect_type_list | String [] | 否 | 类型集合 | ["gmv"] |
| algo_query_v_o.dmc_type_element | String | 否 | 业务字段 dmc_type_element | dayBudget |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_algo_geteffectprediction_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_algo_geteffectprediction_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_algo_geteffectprediction_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_algo_geteffectprediction_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_algo_geteffectprediction_response.top_result.info.error_code |
| top_result.effect_predict_v_o | EffectPredictVO | 未标注 | 业务对象 | — | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o |
| top_result.effect_predict_v_o.pv | Number | 未标注 | 业务字段 pv | 1621 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.pv |
| top_result.effect_predict_v_o.pv_low | Number | 未标注 | 业务字段 pv_low | 1297 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.pv_low |
| top_result.effect_predict_v_o.pv_high | Number | 未标注 | 业务字段 pv_high | 1945 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.pv_high |
| top_result.effect_predict_v_o.click | Number | 未标注 | 点击次数 | 97 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.click |
| top_result.effect_predict_v_o.click_low | Number | 未标注 | 业务字段 click_low | 78 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.click_low |
| top_result.effect_predict_v_o.click_high | Number | 未标注 | 业务字段 click_high | 117 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.click_high |
| top_result.effect_predict_v_o.conv | Number | 未标注 | 业务字段 conv | 13 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.conv |
| top_result.effect_predict_v_o.conv_low | Number | 未标注 | 业务字段 conv_low | 10 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.conv_low |
| top_result.effect_predict_v_o.conv_high | Number | 未标注 | 业务字段 conv_high | 15 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.conv_high |
| top_result.effect_predict_v_o.wconv | Number | 未标注 | 业务字段 wconv | 27 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.wconv |
| top_result.effect_predict_v_o.wconv_low | Number | 未标注 | 业务字段 wconv_low | 22 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.wconv_low |
| top_result.effect_predict_v_o.wconv_high | Number | 未标注 | 业务字段 wconv_high | 33 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.wconv_high |
| top_result.effect_predict_v_o.mem | Number | 未标注 | 业务字段 mem | 0 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.mem |
| top_result.effect_predict_v_o.mem_low | Number | 未标注 | 业务字段 mem_low | 0 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.mem_low |
| top_result.effect_predict_v_o.mem_high | Number | 未标注 | 业务字段 mem_high | 1 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.mem_high |
| top_result.effect_predict_v_o.cost | String | 未标注 | 业务字段 cost；计量单位：元 | 823.83 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cost |
| top_result.effect_predict_v_o.cost_low | String | 未标注 | 业务字段 cost_low；计量单位：元 | 659.06 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cost_low |
| top_result.effect_predict_v_o.cost_high | String | 未标注 | 业务字段 cost_high；计量单位：元 | 988.60 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cost_high |
| top_result.effect_predict_v_o.cart | Number | 未标注 | 业务字段 cart | 10 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cart |
| top_result.effect_predict_v_o.cart_low | Number | 未标注 | 业务字段 cart_low | 5 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cart_low |
| top_result.effect_predict_v_o.cart_high | Number | 未标注 | 业务字段 cart_high | 15 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.cart_high |
| top_result.effect_predict_v_o.uv_aim_low | Number | 未标注 | 业务字段 uv_aim_low | 5 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.uv_aim_low |
| top_result.effect_predict_v_o.uv_aim_high | Number | 未标注 | 业务字段 uv_aim_high | 15 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.uv_aim_high |
| top_result.effect_predict_v_o.gmv | String | 未标注 | 业务字段 gmv | 6845.21 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv |
| top_result.effect_predict_v_o.gmv_net | String | 未标注 | 业务字段 gmv_net | 6845.21 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_net |
| top_result.effect_predict_v_o.gmv_low | String | 未标注 | 业务字段 gmv_low | 5476.17 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_low |
| top_result.effect_predict_v_o.gmv_high | String | 未标注 | 业务字段 gmv_high | 8214.26 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_high |
| top_result.effect_predict_v_o.gmv_low_net | String | 未标注 | 业务字段 gmv_low_net | 5476.17 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_low_net |
| top_result.effect_predict_v_o.gmv_high_net | String | 未标注 | 业务字段 gmv_high_net | 8214.26 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_high_net |
| top_result.effect_predict_v_o.min_gmv | String | 未标注 | 业务字段 min_gmv | 5476.17 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.min_gmv |
| top_result.effect_predict_v_o.max_gmv | String | 未标注 | 业务字段 max_gmv | 8214.26 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.max_gmv |
| top_result.effect_predict_v_o.success_ratio_high | String | 未标注 | 业务字段 success_ratio_high | 0.9 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.success_ratio_high |
| top_result.effect_predict_v_o.success_ratio_low | String | 未标注 | 业务字段 success_ratio_low | 0.8 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.success_ratio_low |
| top_result.effect_predict_v_o.gmv_diff_percent | String | 未标注 | 业务字段 gmv_diff_percent | 0.67 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.gmv_diff_percent |
| top_result.effect_predict_v_o.effect_predict_reason | String | 未标注 | 业务字段 effect_predict_reason | 预计曝光量<span number=\"highlight\">+20%</span>，自然流量助推<span number=\"error\">+10%</span> | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.effect_predict_reason |
| top_result.effect_predict_v_o.reason | String | 未标注 | 业务字段 reason | 预计可获得点击量2次 | universalbp_new_algo_geteffectprediction_response.top_result.effect_predict_v_o.reason |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.algo.geteffectprediction",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "algo_query_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.algo.geteffectprediction\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"algo_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：36164e8f8d9f82fc484e07364232270dfe8af924db9351da68ad9f09c82a0b8a



---

# 创意角色判断

`taobao.universalbp.new.creative.check.role`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_role_query_v_o | CreativeRoleQueryVO | 是 | 创意查询对象 | — |
| creative_role_query_v_o.role_code | String | 是 | 业务字段 role_code | CREATIVE_SECOND_UPGRADE |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_check_role_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_check_role_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_check_role_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_check_role_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_check_role_response.top_result.info.error_code |
| top_result.creative_role_v_o | CreativeRoleVO | 未标注 | 创意对象 | — | universalbp_new_creative_check_role_response.top_result.creative_role_v_o |
| top_result.creative_role_v_o.role_code | String | 未标注 | 业务字段 role_code | CREATIVE_SECOND_UPGRADE | universalbp_new_creative_check_role_response.top_result.creative_role_v_o.role_code |
| top_result.creative_role_v_o.is_user | Boolean | 未标注 | 业务字段 is_user | true | universalbp_new_creative_check_role_response.top_result.creative_role_v_o.is_user |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.check.role",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_role_query_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.creative.check.role\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_role_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：8022a6491b9a6199ac45169bbaf8096e34a3f9229cd202d2bad742437ec053ee



---

# 素材报表

`taobao.universalbp.new.creative.report.material`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | onebpSearch |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| material_report_query_v_o | MaterialReportQueryVO | 是 | 素材报表查询 | — |
| material_report_query_v_o.creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| material_report_query_v_o.creative_id_list | Number [] | 否 | 创意标识列表 | [6843262308] |
| material_report_query_v_o.material_type | String | 否 | 素材类型 | title |
| material_report_query_v_o.campaign_id_in_list | Number [] | 否 | 计划标识集合 | [7843262308] |
| material_report_query_v_o.adgroup_id_in_list | Number [] | 否 | 单元标识集合 | [6943262308] |
| material_report_query_v_o.rpt_query | RptQueryVO | 否 | 查询对象 | — |
| material_report_query_v_o.rpt_query.fields | String | 否 | 业务字段 fields | adPv,click,charge,ctr,ecpc,ecpm |
| material_report_query_v_o.rpt_query.condition_list | RptQueryConditionVO [] | 否 | 列表集合 | — |
| material_report_query_v_o.rpt_query.condition_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-10-08 |
| material_report_query_v_o.rpt_query.condition_list[].end_time | String | 否 | 查询或投放结束时间 | 2023-10-08 |
| material_report_query_v_o.rpt_query.condition_list[].adzone_pkg_id_list | String [] | 否 | 标识集合 | ["114790550288", "114790550289", "114793500012", "114786650498"] |
| material_report_query_v_o.rpt_query.condition_list[].is_rt | Boolean | 否 | 业务字段 is_rt | true |
| material_report_query_v_o.rpt_query.condition_list[].unify_type | String | 否 | 转化归因口径 | zhai |
| material_report_query_v_o.rpt_query.condition_list[].source_list | String [] | 否 | 业务条件集合 | ["campaign_detail","adgroup_list"] |
| material_report_query_v_o.split_type | String | 否 | 统计拆分方式 | day |
| material_report_query_v_o.unify_type | String | 否 | 转化归因口径 | zhai |
| material_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2026-01-01 |
| material_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2026-01-01 |
| material_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| material_report_query_v_o.query_domains | String [] | 否 | 统计维度集合 | creative |
| material_report_query_v_o.query_field_in_list | String [] | 否 | 返回指标集合 | adPv |
| material_report_query_v_o.rpt_type | String | 否 | 业务字段 rpt_type | creative |
| material_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| material_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_report_material_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_report_material_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_report_material_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_report_material_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_report_material_response.top_result.info.error_code |
| top_result.creative_v_o | CreativeVO | 未标注 | 创意 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o |
| top_result.creative_v_o.creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_id |
| top_result.creative_v_o.creative_name | String | 未标注 | 广告创意名称 | sss | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_name |
| top_result.creative_v_o.adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adgroup_id |
| top_result.creative_v_o.creative_type | Number | 未标注 | 创意类型；枚举：1=静态创意、2=智能创意、3=PSD创意、4=动态文案创意、5=自动化创意、6=智能创意、7=综合静态创意、8=综合智能创意、9=自动直播创意、10=元素化创意、11=素材类创意、12=钻展多图创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_type |
| top_result.creative_v_o.source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.source |
| top_result.creative_v_o.creative_center_id | String | 未标注 | 创意标识 | 225349579 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_center_id |
| top_result.creative_v_o.format | Number | 未标注 | 业务字段 format；枚举：1=文字、2=图片、3=Flash、4=视频、5=文字链、9=FLASH不遮盖、10=创意模板、11=视频直播、12=微视频、203=智能创意-三图创意 | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.format |
| top_result.creative_v_o.material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list |
| top_result.creative_v_o.material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].material_id |
| top_result.creative_v_o.material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].video_id |
| top_result.creative_v_o.material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].source |
| top_result.creative_v_o.material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o.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 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].format_type |
| top_result.creative_v_o.material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].url |
| top_result.creative_v_o.material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o.template_id | Number | 未标注 | 模板标识 | 2000000000 | universalbp_new_creative_report_material_response.top_result.creative_v_o.template_id |
| top_result.creative_v_o.outer_id | Number | 未标注 | 业务对象标识 | 225349579 | universalbp_new_creative_report_material_response.top_result.creative_v_o.outer_id |
| top_result.creative_v_o.js_in_html | String | 未标注 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_report_material_response.top_result.creative_v_o.js_in_html |
| top_result.creative_v_o.template_data | String | 未标注 | 业务字段 template_data | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.template_data |
| top_result.creative_v_o.clickurl_media_type_list | String [] | 未标注 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] | universalbp_new_creative_report_material_response.top_result.creative_v_o.clickurl_media_type_list |
| top_result.creative_v_o.audit | AuditVO | 未标注 | 业务对象 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit |
| top_result.creative_v_o.audit.status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.status |
| top_result.creative_v_o.audit.tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.tag_name |
| top_result.creative_v_o.audit.audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.audit_status |
| top_result.creative_v_o.audit.effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.effective_time |
| top_result.creative_v_o.audit.expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.expire_time |
| top_result.creative_v_o.audit.audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.audit_reason |
| top_result.creative_v_o.audit.reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list |
| top_result.creative_v_o.audit.reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].block_id |
| top_result.creative_v_o.audit.reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].block_name |
| top_result.creative_v_o.audit.reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].block_url |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.creative_v_o.audit.reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit.reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.creative_v_o.adzone_audit_result_list | AuditVO [] | 未标注 | 结果列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list |
| top_result.creative_v_o.adzone_audit_result_list[].status | String | 未标注 | 状态标识；枚举：PW=待送审、W=待审核、P=审核通过、R=审核拒绝、AW=合成中、AP=合成通过、AR=合成失败、T=排查中、PP=部分通过、E=创意过期、A=创意故障 | W | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].status |
| top_result.creative_v_o.adzone_audit_result_list[].tag_name | String | 未标注 | 业务字段 tag_name | 猜你喜欢信息流 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].tag_name |
| top_result.creative_v_o.adzone_audit_result_list[].audit_status | Number | 未标注 | 业务字段 audit_status；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].audit_status |
| top_result.creative_v_o.adzone_audit_result_list[].effective_time | String | 未标注 | 业务字段 effective_time | 2023-05-29 18:21:40 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].effective_time |
| top_result.creative_v_o.adzone_audit_result_list[].expire_time | String | 未标注 | 业务字段 expire_time | 2999-12-31 23:59:59 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].expire_time |
| top_result.creative_v_o.adzone_audit_result_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 直播已结束，结束后创意自动变为审核拒绝状态 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].audit_reason |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list | BlockReasonVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_id |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].block_name | String | 未标注 | 业务字段 block_name | 推广图片 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_name |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].block_url |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os | ReasonVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_id | Number | 未标注 | 业务对象标识 | 6632 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_id |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_reason_name | String | 未标注 | 业务字段 audit_reason_name | 推广信息中推广特殊用途化xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_reason_name |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].redirect_url | String | 未标注 | 业务字段 redirect_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].redirect_url |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].flaw_urls | String [] | 未标注 | 业务字段 flaw_urls | ["http://help.alimama.com"] | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].flaw_urls |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_id | Number | 未标注 | 业务对象标识 | 336 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_id |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_block_name | String | 未标注 | 业务字段 audit_block_name | 推广图片 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_block_name |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].block_url | String | 未标注 | 业务字段 block_url | http://help.alimama.com | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].block_url |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].remark | String | 未标注 | 业务字段 remark | 发布内容不得出现引人不适内容 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].remark |
| top_result.creative_v_o.adzone_audit_result_list[].reason_list[].reason_d_t_os[].audit_time | String | 未标注 | 业务字段 audit_time | 2024-12-02 20:51:43 | universalbp_new_creative_report_material_response.top_result.creative_v_o.adzone_audit_result_list.audit_v_o[].reason_list.block_reason_v_o[].reason_d_t_os.reason_v_o[].audit_time |
| top_result.creative_v_o.preview_list | CreativeAdzonePreviewVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list |
| top_result.creative_v_o.preview_list[].adzone_type | Number | 未标注 | 业务字段 adzone_type；枚举：1=首焦、2=猜你喜欢、3=NewDetail | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].adzone_type |
| top_result.creative_v_o.preview_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].adzone_name |
| top_result.creative_v_o.preview_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].adzone_id |
| top_result.creative_v_o.preview_list[].preview_data_list | CreativePreviewResultVO [] | 未标注 | 列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_format | Number | 未标注 | 业务字段 preview_format；枚举：2=图片、10=创意模板、12=微视频 | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_format |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_img_url | String | 未标注 | 业务字段 preview_img_url | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_img_url |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_click_url | String | 未标注 | 业务字段 preview_click_url | https://a.m.taobao.com/i678729730773.htm | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_click_url |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_size | String | 未标注 | 业务字段 preview_size | 342x530 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_size |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_scale | String | 未标注 | 业务字段 preview_scale | 0.5 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_scale |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_video_path | String | 未标注 | 业务字段 preview_video_path | 342x530 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_path |
| top_result.creative_v_o.preview_list[].preview_data_list[].preview_video_image | String | 未标注 | 业务字段 preview_video_image | 342x530 | universalbp_new_creative_report_material_response.top_result.creative_v_o.preview_list.creative_adzone_preview_v_o[].preview_data_list.creative_preview_result_v_o[].preview_video_image |
| top_result.creative_v_o.creative_size | String | 未标注 | 业务字段 creative_size | 513x750 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_size |
| top_result.creative_v_o.item_videos | ItemVideoVO [] | 未标注 | 商品集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos |
| top_result.creative_v_o.item_videos[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].cover_url |
| top_result.creative_v_o.item_videos[].poster | String | 未标注 | 业务字段 poster | https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].poster |
| top_result.creative_v_o.item_videos[].item_id | Number | 未标注 | 商品编号 | 708275631127 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].item_id |
| top_result.creative_v_o.item_videos[].video_url | String | 未标注 | 业务字段 video_url | https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].video_url |
| top_result.creative_v_o.item_videos[].audit_state | Number | 未标注 | 业务字段 audit_state；枚举：-10=to_promote、-4=tobeadd、-3=feed_handle、-2=reject、-1=handle、0=notchecked、1=passed、-9=qa_reject、-5=uneffect、-7=item_offshelf、-11=business_reject、-12=to_outer_audit、-13=handle_tanx、-14=part_reject、-15=to_rational_audit、-16=part_passed | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].audit_state |
| top_result.creative_v_o.item_videos[].audit_desc | String | 未标注 | 业务字段 audit_desc | xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].audit_desc |
| top_result.creative_v_o.item_videos[].video_id | Number | 未标注 | 视频标识 | 415780011227 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].video_id |
| top_result.creative_v_o.item_videos[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].source |
| top_result.creative_v_o.item_videos[].type | Number | 未标注 | 类型；枚举：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 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].type |
| top_result.creative_v_o.item_videos[].width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].width |
| top_result.creative_v_o.item_videos[].height | Number | 未标注 | 业务字段 height | 1200 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].height |
| top_result.creative_v_o.item_videos[].duration | Number | 未标注 | 业务字段 duration | 32 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].duration |
| top_result.creative_v_o.item_videos[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_videos.item_video_v_o[].haitang_id |
| top_result.creative_v_o.online_status | Number | 未标注 | 投放上下线状态；枚举：1=ON、-1=ARCHIVE | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.online_status |
| top_result.creative_v_o.start_time | String | 未标注 | 查询或投放起始时间 | 2023-05-29 18:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.start_time |
| top_result.creative_v_o.end_time | String | 未标注 | 查询或投放结束时间 | 2024-05-28 17:59:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.end_time |
| top_result.creative_v_o.create_time | String | 未标注 | 业务字段 create_time | 2023-05-29 18:21:40 | universalbp_new_creative_report_material_response.top_result.creative_v_o.create_time |
| top_result.creative_v_o.update_time | String | 未标注 | 业务字段 update_time | 2023-05-29 18:21:40 | universalbp_new_creative_report_material_response.top_result.creative_v_o.update_time |
| top_result.creative_v_o.creative_promotion_entity | CreativePromotionEntityVO | 未标注 | 创意对象 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity |
| top_result.creative_v_o.creative_promotion_entity.promotion_type | String | 未标注 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.promotion_type |
| top_result.creative_v_o.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 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.sub_promotion_type |
| top_result.creative_v_o.creative_promotion_entity.promotion_entity_id | Number | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.promotion_entity_id |
| top_result.creative_v_o.creative_promotion_entity.material | PromotionMaterialInfoVO | 未标注 | 素材 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material |
| top_result.creative_v_o.creative_promotion_entity.material.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material.material_id |
| top_result.creative_v_o.creative_promotion_entity.material.img_url | String | 未标注 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material.img_url |
| top_result.creative_v_o.creative_promotion_entity.material.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material.link_url |
| top_result.creative_v_o.creative_promotion_entity.material.material_name | String | 未标注 | 素材名称 | yiliantest测试请不要拍22 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material.material_name |
| top_result.creative_v_o.creative_promotion_entity.material.title | String | 未标注 | 展示标题 | yiliantest测试请不要拍22 | universalbp_new_creative_report_material_response.top_result.creative_v_o.creative_promotion_entity.material.title |
| top_result.creative_v_o.extend_data | String | 未标注 | 业务字段 extend_data | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html | universalbp_new_creative_report_material_response.top_result.creative_v_o.extend_data |
| top_result.creative_v_o.material_image_info | MaterialImageInfoVO | 未标注 | 素材图片对象 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info |
| top_result.creative_v_o.material_image_info.material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.material_id |
| top_result.creative_v_o.material_image_info.sync_key | String | 未标注 | 业务字段 sync_key | xxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.sync_key |
| top_result.creative_v_o.material_image_info.image_position | Number | 未标注 | 业务字段 image_position | 0 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.image_position |
| top_result.creative_v_o.material_image_info.img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.img_url |
| top_result.creative_v_o.material_image_info.link_url | String | 未标注 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.link_url |
| top_result.creative_v_o.material_image_info.material_name | String | 未标注 | 素材名称 | 外投宝贝测试，请不要拍 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.material_name |
| top_result.creative_v_o.material_image_info.image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.image_id |
| top_result.creative_v_o.material_image_info.size | String | 未标注 | 业务字段 size | 800*800 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.size |
| top_result.creative_v_o.material_image_info.width | Number | 未标注 | 业务字段 width | 800 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.width |
| top_result.creative_v_o.material_image_info.height | Number | 未标注 | 业务字段 height | 800 | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.height |
| top_result.creative_v_o.material_image_info.image_properties | String | 未标注 | 业务字段 image_properties | xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.material_image_info.image_properties |
| top_result.creative_v_o.title | String | 未标注 | 展示标题 | 薄荷脑软膏,测试请不要拍 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title |
| top_result.creative_v_o.image_path | String | 未标注 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.image_path |
| top_result.creative_v_o.click_url | String | 未标注 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm | universalbp_new_creative_report_material_response.top_result.creative_v_o.click_url |
| top_result.creative_v_o.video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_report_material_response.top_result.creative_v_o.video_id |
| top_result.creative_v_o.video_duration | String | 未标注 | 业务字段 video_duration | 10 | universalbp_new_creative_report_material_response.top_result.creative_v_o.video_duration |
| top_result.creative_v_o.video_path | String | 未标注 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 | universalbp_new_creative_report_material_response.top_result.creative_v_o.video_path |
| top_result.creative_v_o.video_image_path | String | 未标注 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.video_image_path |
| top_result.creative_v_o.item_id_list | Number [] | 未标注 | 商品标识列表 | [679056995041] | universalbp_new_creative_report_material_response.top_result.creative_v_o.item_id_list |
| top_result.creative_v_o.children | CreativeChildrenVO [] | 未标注 | 业务集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.children |
| top_result.creative_v_o.children[].material_list | ItemMaterialVO [] | 未标注 | 素材列表 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list |
| top_result.creative_v_o.children[].material_list[].material_id | Number | 未标注 | 素材标识 | 714616513841 | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].material_id |
| top_result.creative_v_o.children[].material_list[].video_id | Number | 未标注 | 视频标识 | 398436114008 | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].video_id |
| top_result.creative_v_o.children[].material_list[].source | Number | 未标注 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].source |
| top_result.creative_v_o.children[].material_list[].haitang_id | Number | 未标注 | 业务对象标识 | 989898 | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].haitang_id |
| top_result.creative_v_o.children[].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 | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].format_type |
| top_result.creative_v_o.children[].material_list[].url | String | 未标注 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].url |
| top_result.creative_v_o.children[].material_list[].cover_url | String | 未标注 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png | universalbp_new_creative_report_material_response.top_result.creative_v_o.children.creative_children_v_o[].material_list.item_material_v_o[].cover_url |
| top_result.creative_v_o.tab_type | String | 未标注 | 业务字段 tab_type；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_report_material_response.top_result.creative_v_o.tab_type |
| top_result.creative_v_o.tab_type_name | String | 未标注 | 业务字段 tab_type_name；枚举：101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 | universalbp_new_creative_report_material_response.top_result.creative_v_o.tab_type_name |
| top_result.creative_v_o.type_name | String | 未标注 | 类型名称；枚举：1=自定义创意、5=智能创意 | 自定义创意 | universalbp_new_creative_report_material_response.top_result.creative_v_o.type_name |
| top_result.creative_v_o.type | String | 未标注 | 类型；枚举：1=自定义创意、5=智能创意 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.type |
| top_result.creative_v_o.main_pic_video | String | 未标注 | 业务字段 main_pic_video | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.main_pic_video |
| top_result.creative_v_o.media_material_count | Number | 未标注 | 业务字段 media_material_count | 5 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_count |
| top_result.creative_v_o.title_material_count | Number | 未标注 | 业务字段 title_material_count | 5 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_count |
| top_result.creative_v_o.media_material_list | MediaMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list |
| top_result.creative_v_o.media_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].creative_id |
| top_result.creative_v_o.media_material_list[].format | Number | 未标注 | 业务字段 format | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].format |
| top_result.creative_v_o.media_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].start_time |
| top_result.creative_v_o.media_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].end_time |
| top_result.creative_v_o.media_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].effective_time |
| top_result.creative_v_o.media_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].expire_time |
| top_result.creative_v_o.media_material_list[].material_name | String | 未标注 | 素材名称 | 宝贝xxx名称 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].material_name |
| top_result.creative_v_o.media_material_list[].outer_id | Number | 未标注 | 业务对象标识 | 1011 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].outer_id |
| top_result.creative_v_o.media_material_list[].source | Number | 未标注 | 请求来源标识 | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].source |
| top_result.creative_v_o.media_material_list[].tag | String | 未标注 | 业务字段 tag | tag名称 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].tag |
| top_result.creative_v_o.media_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].item_id |
| top_result.creative_v_o.media_material_list[].image_position | Number | 未标注 | 业务字段 image_position | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].image_position |
| top_result.creative_v_o.media_material_list[].image_path | String | 未标注 | 业务字段 image_path | http://localhost | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].image_path |
| top_result.creative_v_o.media_material_list[].video_id | Number | 未标注 | 视频标识 | 1012 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].video_id |
| top_result.creative_v_o.media_material_list[].video_image_path | String | 未标注 | 业务字段 video_image_path | http://localhost | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].video_image_path |
| top_result.creative_v_o.media_material_list[].video_path | String | 未标注 | 业务字段 video_path | http://localhost | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].video_path |
| top_result.creative_v_o.media_material_list[].width | Number | 未标注 | 业务字段 width | 200 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].width |
| top_result.creative_v_o.media_material_list[].height | Number | 未标注 | 业务字段 height | 400 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].height |
| top_result.creative_v_o.media_material_list[].sync_key | String | 未标注 | 业务字段 sync_key | xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].sync_key |
| top_result.creative_v_o.media_material_list[].image_id | Number | 未标注 | 图片标识 | 101 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].image_id |
| top_result.creative_v_o.media_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].material_type |
| top_result.creative_v_o.media_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].material_id |
| top_result.creative_v_o.media_material_list[].haitang_source | Number | 未标注 | 业务字段 haitang_source | 1 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].haitang_source |
| top_result.creative_v_o.media_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_v_o.media_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].origin_material_type |
| top_result.creative_v_o.media_material_list[].image_properties | String | 未标注 | 业务字段 image_properties | 251005701:5342939018 | universalbp_new_creative_report_material_response.top_result.creative_v_o.media_material_list.media_material_info_v_o[].image_properties |
| top_result.creative_v_o.title_material_list | TextMaterialInfoVO [] | 未标注 | 素材列表集合 | — | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list |
| top_result.creative_v_o.title_material_list[].creative_id | Number | 未标注 | 广告创意编号 | 6843262308 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].creative_id |
| top_result.creative_v_o.title_material_list[].material_id | Number | 未标注 | 素材标识 | 714894818852 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].material_id |
| top_result.creative_v_o.title_material_list[].item_id | Number | 未标注 | 商品编号 | 6843262308 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].item_id |
| top_result.creative_v_o.title_material_list[].start_time | Date | 未标注 | 查询或投放起始时间 | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].start_time |
| top_result.creative_v_o.title_material_list[].end_time | Date | 未标注 | 查询或投放结束时间 | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].end_time |
| top_result.creative_v_o.title_material_list[].effective_time | Date | 未标注 | 业务字段 effective_time | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].effective_time |
| top_result.creative_v_o.title_material_list[].expire_time | Date | 未标注 | 业务字段 expire_time | 2024-01-01 00:00:00 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].expire_time |
| top_result.creative_v_o.title_material_list[].content_type | String | 未标注 | 内容类型 | title | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].content_type |
| top_result.creative_v_o.title_material_list[].content | String | 未标注 | 内容 | xxxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].content |
| top_result.creative_v_o.title_material_list[].material_type | String | 未标注 | 素材类型 | title | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].material_type |
| top_result.creative_v_o.title_material_list[].source | Number | 未标注 | 请求来源标识 | 2 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].source |
| top_result.creative_v_o.title_material_list[].report_info | String | 未标注 | 业务字段 report_info | — | — |
| top_result.creative_v_o.title_material_list[].origin_material_type | Number | 未标注 | 业务字段 origin_material_type | 121 | universalbp_new_creative_report_material_response.top_result.creative_v_o.title_material_list.text_material_info_v_o[].origin_material_type |
| top_result.creative_v_o.report_info_map | String | 未标注 | 业务字段 report_info_map | — | — |
| top_result.creative_v_o.audit_reject_info | String | 未标注 | 业务字段 audit_reject_info | xxxxx | universalbp_new_creative_report_material_response.top_result.creative_v_o.audit_reject_info |
| top_result.creative_v_o.qzt_white | Number | 未标注 | 业务字段 qzt_white | 0 | universalbp_new_creative_report_material_response.top_result.creative_v_o.qzt_white |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.report.material",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "material_report_query_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.creative.report.material\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"material_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：823a7dd3f06803d2974b10fb2a312e811e7d54199eba11b99a89609f0c5f4e34



---

# 编辑解决方案

`taobao.universalbp.new.solution.modify`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| solution_command_list_v_o | SolutionCommandListVO | 是 | 操作列表对象 | — |
| solution_command_list_v_o.solution_list | SolutionCommandVO [] | 是 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].biz_code | String | 是 | 推广场景标识 | onebpDisplay |
| solution_command_list_v_o.solution_list[].campaign | CampaignCommandVO | 是 | 计划 | — |
| solution_command_list_v_o.solution_list[].campaign.campaign_biz_code | String | 否 | 业务字段 campaign_biz_code | onebpDisplay |
| solution_command_list_v_o.solution_list[].campaign.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.top_status | Boolean | 否 | 是否置顶；枚举：true=置顶、false=不置顶 | true |
| solution_command_list_v_o.solution_list[].campaign.campaign_group_id | Number | 否 | 计划标识；计划组已经存在场景必填 | 25481004 |
| solution_command_list_v_o.solution_list[].campaign.campaign_name | String | 否 | 推广计划名称 | 管家计划_宝贝候选集 |
| solution_command_list_v_o.solution_list[].campaign.campaign_model | String | 否 | 业务字段 campaign_model | daily:持续推广,order:套餐包 |
| solution_command_list_v_o.solution_list[].campaign.promotion_model | String | 否 | 业务字段 promotion_model | daily:持续推广,order:套餐包 |
| solution_command_list_v_o.solution_list[].campaign.promotion_scene | String | 否 | 业务字段 promotion_scene；枚举：promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量（CPC）、WXT_AGENCY_XST_CPA=服务商版客源多（CPA）、WXT_AGENCY_SHEQUN=服务商版社群（CPA+CPS） | promotion_scene_crowd |
| solution_command_list_v_o.solution_list[].campaign.promotion_goals | String | 否 | 业务字段 promotion_goals；枚举：shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情 | traffic_nd |
| solution_command_list_v_o.solution_list[].campaign.optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| solution_command_list_v_o.solution_list[].campaign.dmc_type | String | 否 | 预算方式标识；枚举：normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算 | normal |
| solution_command_list_v_o.solution_list[].campaign.day_budget | Number | 否 | 日预算 | 100 |
| solution_command_list_v_o.solution_list[].campaign.smooth_option | String | 否 | 每日预算投放节奏；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| solution_command_list_v_o.solution_list[].campaign.total_budget | Number | 否 | 累计预算 | 100 |
| solution_command_list_v_o.solution_list[].campaign.budget_period | Number | 否 | 业务字段 budget_period | 7 |
| solution_command_list_v_o.solution_list[].campaign.period_smooth | String | 否 | 业务字段 period_smooth；枚举：quick=天内尽快、smooth=天内平滑 | smooth |
| solution_command_list_v_o.solution_list[].campaign.bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].campaign.constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| solution_command_list_v_o.solution_list[].campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| solution_command_list_v_o.solution_list[].campaign.cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| solution_command_list_v_o.solution_list[].campaign.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].campaign.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].campaign.sub_promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| solution_command_list_v_o.solution_list[].campaign.promotion_type_list | String [] | 否 | 类型集合 | ["item"] |
| solution_command_list_v_o.solution_list[].campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode；枚举：shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
| solution_command_list_v_o.solution_list[].campaign.item_rec_strategy_list | String [] | 否 | 商品集合 | ["effect_gmv","effect_coll"] |
| solution_command_list_v_o.solution_list[].campaign.shop_item_type | String | 否 | 店铺商品类型；枚举：effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品 | effect |
| solution_command_list_v_o.solution_list[].campaign.shield_items | Number [] | 否 | 业务字段 shield_items | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.scope_items | Number [] | 否 | 业务字段 scope_items | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.main_pic_video | String | 否 | 业务字段 main_pic_video | 1 |
| solution_command_list_v_o.solution_list[].campaign.auto_wang_wang_pic | String | 否 | 业务字段 auto_wang_wang_pic | 1 |
| solution_command_list_v_o.solution_list[].campaign.creative_optimization | String | 否 | 业务字段 creative_optimization；枚举：black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | black_creative |
| solution_command_list_v_o.solution_list[].campaign.creative_set_mode | String | 否 | 业务字段 creative_set_mode；枚举：minimalist=极简版、professional=专业版 | professional |
| solution_command_list_v_o.solution_list[].campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["1","19"] 或者 ["all"] |
| solution_command_list_v_o.solution_list[].campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.shield_categories | CategoryCommandVO [] | 否 | 业务集合 | — |
| solution_command_list_v_o.solution_list[].campaign.shield_categories[].cat_id | Number | 否 | 业务对象标识 | 35 |
| solution_command_list_v_o.solution_list[].campaign.shield_categories[].cat_name | String | 否 | 业务字段 cat_name | 童装/婴儿装/亲子装 |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list | TrendThemeCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list[].trend_theme_id | Number | 否 | 业务对象标识 | 566987194 |
| solution_command_list_v_o.solution_list[].campaign.trend_theme_list[].trend_theme_name | String | 否 | 业务字段 trend_theme_name | 无边发光字 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_type | String | 否 | 业务字段 launch_period_type | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| solution_command_list_v_o.solution_list[].campaign.spot_continue | Number | 否 | 业务字段 spot_continue | 1 |
| solution_command_list_v_o.solution_list[].campaign.mini_detail | CampaignMiniDetailCommandVO | 否 | 业务对象 | — |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.mini_detail_theme | String | 否 | 业务字段 mini_detail_theme；枚举：1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题 | 1 |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203, 714901906337] |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_top_item_id_list | Number [] | 否 | 商品标识集合 | [714707465203] |
| solution_command_list_v_o.solution_list[].campaign.mini_detail.private_mini_type | Number | 否 | 业务字段 private_mini_type；枚举：0=黑名单、1=白名单 | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list | CampaignCrowdFilterVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list[].behavior | String | 否 | 业务字段 behavior；枚举：purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群 | shop_crowd |
| solution_command_list_v_o.solution_list[].campaign.crowd_filter_list[].window | String | 否 | 业务字段 window；枚举：7=7天、15=15天、30=30天、90=90天、180=180天、365=365天 | 7 |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list | CampaignBrandFilterVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list[].brand_id | String | 否 | 业务对象标识 | 20067 |
| solution_command_list_v_o.solution_list[].campaign.brand_filter_list[].deeplink_list | String [] | 否 | 业务条件集合；枚举：Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱 | ["Engage"] |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list | DeeplinkBrandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list[].deeplink_brand_id | String | 否 | 业务对象标识 | 20067 |
| solution_command_list_v_o.solution_list[].campaign.deeplink_brand_list[].deeplink_brand_name | String | 否 | 业务字段 deeplink_brand_name | Lancome/兰蔻 |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list | CampaignGenderAgeFilterVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list[].gender | String | 否 | 业务字段 gender；枚举：man=男性人群、woman=女性人群 | man |
| solution_command_list_v_o.solution_list[].campaign.gender_age_filter_list[].age_list | String [] | 否 | 业务条件集合；枚举：0=18岁以下、1=18-24岁、2=25-29岁、3=30-34岁、4=35-39岁、5=40-49岁、6=50岁以上 | [0, 1, 2, 3, 4, 5, 6] |
| solution_command_list_v_o.solution_list[].campaign.category_crowd_type | String | 否 | 业务字段 category_crowd_type；枚举：0=全域拉新、1=同类目拉新、2=跨类目拉新、7=OAI人群 | 0 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| solution_command_list_v_o.solution_list[].campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| solution_command_list_v_o.solution_list[].campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd | CrowdRefCommandVO | 否 | 人群对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.extend_crowd.price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.target_crowd | String | 否 | 目标人群；枚举：ShopNew=店铺新客、brandNew=品牌新客 | ShopNew |
| solution_command_list_v_o.solution_list[].campaign.scene_target | String | 否 | 业务字段 scene_target；枚举：InShopNew=新客访问、InterestNew=新客兴趣加深、BuyNew=新客成交 | BuyNew |
| solution_command_list_v_o.solution_list[].campaign.source_channel | String | 否 | 业务字段 source_channel | adStrategyDurationPC |
| solution_command_list_v_o.solution_list[].campaign.speed_type | String | 否 | 业务字段 speed_type | smooth |
| solution_command_list_v_o.solution_list[].campaign.exposure_time | Number | 否 | 业务字段 exposure_time | 2 |
| solution_command_list_v_o.solution_list[].campaign.plan_id | Number | 否 | 业务对象标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.auto_renewal | Boolean | 否 | 业务字段 auto_renewal | true |
| solution_command_list_v_o.solution_list[].campaign.order_info | CampaignOrderInfoVO | 否 | 业务对象 | — |
| solution_command_list_v_o.solution_list[].campaign.order_info.plan_id | Number | 否 | 业务对象标识 | 260699 |
| solution_command_list_v_o.solution_list[].campaign.order_info.plan_name | String | 否 | 业务字段 plan_name | 测试 |
| solution_command_list_v_o.solution_list[].campaign.order_info.order_amount | String | 否 | 业务字段 order_amount | 0.01 |
| solution_command_list_v_o.solution_list[].campaign.order_info.max_period | Number | 否 | 业务字段 max_period | 30 |
| solution_command_list_v_o.solution_list[].campaign.order_info.min_period | Number | 否 | 业务字段 min_period | 3 |
| solution_command_list_v_o.solution_list[].campaign.order_info.total_stock | Number | 否 | 业务字段 total_stock | 30 |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch | true |
| solution_command_list_v_o.solution_list[].campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| solution_command_list_v_o.solution_list[].campaign.is_budget_schedule_open | Boolean | 否 | 业务字段 is_budget_schedule_open | true |
| solution_command_list_v_o.solution_list[].campaign.market_aim_type | String | 否 | 业务字段 market_aim_type；枚举：fixed_target=固定目标、auto_trans=自动流转 | fixed_target |
| solution_command_list_v_o.solution_list[].campaign.search_detent_type | String | 否 | 业务字段 search_detent_type | first_place |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list | AdgroupCommandVO [] | 否 | 单元列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 3 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| solution_command_list_v_o.solution_list[].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 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| solution_command_list_v_o.solution_list[].campaign.adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| solution_command_list_v_o.solution_list[].campaign.more_campaign_switch | Boolean | 否 | 业务字段 more_campaign_switch | false |
| solution_command_list_v_o.solution_list[].campaign.conv | Number | 否 | 业务字段 conv | 10 |
| solution_command_list_v_o.solution_list[].campaign.common_filters | String | 否 | 业务字段 common_filters | — |
| solution_command_list_v_o.solution_list[].campaign.smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].campaign.crowd_extend_type | String | 否 | 业务字段 crowd_extend_type | auto |
| solution_command_list_v_o.solution_list[].campaign.whole_member_ship | Boolean | 否 | 业务字段 whole_member_ship | false |
| solution_command_list_v_o.solution_list[].campaign.crowd_custom_type | Boolean | 否 | 业务字段 crowd_custom_type | false |
| solution_command_list_v_o.solution_list[].campaign.creative_skin | String | 否 | 业务字段 creative_skin | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list | AdgroupCommandVO [] | 是 | 单元列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| solution_command_list_v_o.solution_list[].adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| solution_command_list_v_o.solution_list[].adgroup_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list | WordCommandVO [] | 否 | 词列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].word | String | 否 | 词 | 鞋原创小众 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list | WordPackageCommandVO [] | 否 | 词列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_id | Number | 否 | 词标识；词包已经存在场景必填 | 38577 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_name | String | 否 | 业务字段 word_package_name | 流量智选 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].word_package_type | Number | 否 | 业务字段 word_package_type；枚举：0=流量智选、1=好词优选、19=捡漏、20=卖点词包、21=类目优选 | 20 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].status | Number | 否 | 状态标识；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].bid_price | String | 否 | 出价金额 | 5 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].discount | Number | 否 | 出价溢价 | 100 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list | WordPackageStrategyCommandVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].strategy_id | Number | 否 | 业务对象标识；枚举：0=流量智选、1=好词优选、2=捡漏、3=类目优选 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].word_package_list[].strategy_list[].bid_price | String | 否 | 出价金额 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].dynamic_title_flag | String | 否 | 业务字段 dynamic_title_flag | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc | AdgroupOcpcCommandVO | 否 | 单元对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| solution_command_list_v_o.solution_list[].adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String | 否 | 业务字段 ocpc_marketing_aim；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、new_item=新品冷启动、new_ad=新广告加速、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量 | click |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list | SpotVO [] | 否 | 列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].spot_id | Number | 否 | 业务对象标识 | 3 |
| solution_command_list_v_o.solution_list[].adgroup_list[].spot_list[].material_name | String | 否 | 素材名称 | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative | Number | 否 | 业务字段 smart_creative | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info | CreativeRefCommandVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.creative_id | Number | 否 | 广告创意编号 | 6845715605 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.creative_id_list | Number [] | 否 | 创意标识列表 | [739684500310001] |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.add_main_pic_video | Boolean | 否 | 业务字段 add_main_pic_video；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.add_auto_creative | Boolean | 否 | 业务字段 add_auto_creative；枚举：true=是、false=否 | true |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list | MaterialImageInfoVO [] | 否 | 素材图片列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].sync_key | String | 否 | 业务字段 sync_key | xxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_position | Number | 否 | 业务字段 image_position | 0 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].img_url | String | 否 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].material_name | String | 否 | 素材名称 | 外投宝贝测试，请不要拍 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].size | String | 否 | 业务字段 size | 800*800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].width | Number | 否 | 业务字段 width | 800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].height | Number | 否 | 业务字段 height | 800 |
| solution_command_list_v_o.solution_list[].adgroup_list[].creative_info.material_image_info_list[].image_properties | String | 否 | 业务字段 image_properties | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list | CreativeCommandVO [] | 否 | 创意列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_type | Number | 否 | 创意类型；枚举：1=自定义创意、5=智能创意 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_name | String | 否 | 广告创意名称 | sss |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、3=CreativeCenter | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].tp_format | Number | 否 | 业务字段 tp_format；枚举：2=图片、10=创意模板、12=微视频 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].start_time | String | 否 | 查询或投放起始时间 | 2023-05-29 18:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].end_time | String | 否 | 查询或投放结束时间 | 2024-05-28 17:59:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title | String | 否 | 展示标题 | 薄荷脑软膏,测试请不要拍 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].image_path | String | 否 | 业务字段 image_path | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].click_url | String | 否 | 业务字段 click_url | https://a.m.taobao.com/i679056995041.htm |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_protection | Number | 否 | 业务字段 creative_protection | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_duration | String | 否 | 业务字段 video_duration | 10 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_path | String | 否 | 业务字段 video_path | https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].video_image_path | String | 否 | 业务字段 video_image_path | https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list | ItemMaterialVO [] | 否 | 素材列表 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].video_id | Number | 否 | 视频标识 | 398436114008 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].source | Number | 否 | 请求来源标识；枚举：1=本地上传、2=BannerMaker、3=CreativeCenter、4=LuBan、5=直播广场、6=活动招商、7=海棠、8=原生创意 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].haitang_id | Number | 否 | 业务对象标识 | 989898 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].format_type | Number | 否 | 业务字段 format_type；枚举：1=图片、2=抄底文案、3=产品词、4=属性词、5=链接、51=淘积木URL、6=文案、7=长图、8=短文本、9=长文本、10=LOGO、11=视频、12=底图、13=tag、14=智能文案、15=促销词、16=标签词、17=优惠券、18=原价、19=折扣价、20=智能标题候选词、21=宝贝图 包括主图 长图 副图、22=宝贝标题、23=智能图、24=美观图、32=短标题、33=算法产出、34=淘宝素材中心图片、35=店铺名称、36=商品SKU图、37=商品详情页图、38=创意图、39=算法加工后的直播间封面图、40=算法加工后的直播间宝贝图、41=算法加工后的直播间宝贝标题文案、42、44=创意样式、45=主搜商品卡片轮播图、46=主搜商品3比4图、47=图标图片、48=二跳短视频、101=用户主标题、102=用户副标题、103=用户标题3、25=长图微视频、26=方图微视频、27=审核通过后原图做成的ppt视频、28=账号头像、29=素材组下非审核素材内容、30=鹿班商品图、31=算法剪辑视频、60=创意中心打包的图(只有外审使用)、50=视频ID素材、124=自动审核通过、125=仅合理性审核的图片、126=仅合理性审核的文案 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].url | String | 否 | 资源地址 | https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_list[].cover_url | String | 否 | 业务字段 cover_url | https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_size | String | 否 | 业务字段 creative_size | 513x750 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity | CreativePromotionEntityVO | 否 | 创意对象 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.sub_promotion_type | String | 否 | 业务字段 sub_promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.promotion_entity_id | Number | 否 | 业务对象标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material | PromotionMaterialInfoVO | 否 | 素材 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_id | Number | 否 | 素材标识 | 714616513841 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.img_url | String | 否 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.link_url | String | 否 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_promotion_entity.material.title | String | 否 | 展示标题 | yiliantest测试请不要拍22 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].template_data | String | 否 | 业务字段 template_data | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].js_in_html | String | 否 | 业务字段 js_in_html | https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].outer_id | Number | 否 | 业务对象标识 | 225349579 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].creative_center_id | String | 否 | 创意标识 | 225349579 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].item_id_list | Number [] | 否 | 商品标识列表 | [679056995041] |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].clickurl_media_type_list | String [] | 否 | 类型集合；枚举：1=PC、2=无线、3=PC和无线 | [1] |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].tab_type | String | 否 | 业务字段 tab_type | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].template_id | Number | 否 | 模板标识 | 2000000000 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].is_clip | Boolean | 否 | 业务字段 is_clip；枚举：true=是、false=否 | false |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].material_group_id | Number | 否 | 素材标识 | 1010 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list | MediaMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tp_format | Number | 否 | 业务字段 tp_format | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_name | String | 否 | 素材名称 | 宝贝xxx名称 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].outer_id | Number | 否 | 业务对象标识 | 1011 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].source | Number | 否 | 请求来源标识 | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].tag | String | 否 | 业务字段 tag | tag名称 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_position | Number | 否 | 业务字段 image_position | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_path | String | 否 | 业务字段 image_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_id | Number | 否 | 视频标识 | 1012 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_image_path | String | 否 | 业务字段 video_image_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].video_path | String | 否 | 业务字段 video_path | http://localhost |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].width | Number | 否 | 业务字段 width | 200 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].height | Number | 否 | 业务字段 height | 400 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].sync_key | String | 否 | 业务字段 sync_key | xxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].image_id | Number | 否 | 图片标识 | 101 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].haitang_source | Number | 否 | 业务字段 haitang_source | 1 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].media_material_list[].report_info | String | 否 | 业务字段 report_info | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list | TextMaterialInfoVO [] | 否 | 素材列表集合 | — |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_id | Number | 否 | 素材标识 | 714894818852 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].item_id | Number | 否 | 商品编号 | 6843262308 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].effective_time | Date | 否 | 业务字段 effective_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].expire_time | Date | 否 | 业务字段 expire_time | 2024-01-01 00:00:00 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content_type | String | 否 | 内容类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].content | String | 否 | 内容 | xxxxxx |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].material_type | String | 否 | 素材类型 | title |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].source | Number | 否 | 请求来源标识 | 2 |
| solution_command_list_v_o.solution_list[].adgroup_list[].smart_creative_package_list[].title_material_list[].report_info | String | 否 | 业务字段 report_info | — |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_solution_modify_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_solution_modify_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_solution_modify_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_solution_modify_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_solution_modify_response.top_result.info.error_code |
| top_result.object_top_part_data | TopPartData | 未标注 | 业务对象 | — | universalbp_new_solution_modify_response.top_result.object_top_part_data |
| top_result.object_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_solution_modify_response.top_result.object_top_part_data.count |
| top_result.object_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_solution_modify_response.top_result.object_top_part_data.error_count |
| top_result.object_top_part_data.error_details | Integer [] | 未标注 | 逐项失败明细 | — | universalbp_new_solution_modify_response.top_result.object_top_part_data.error_details |
| top_result.object_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_solution_modify_response.top_result.object_top_part_data.error_details.integer[].code |
| top_result.object_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_solution_modify_response.top_result.object_top_part_data.error_details.integer[].msg |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

- top_result.object_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_solution_modify_response.top_result.object_top_part_data.error_details）

来源校验 SHA256：24cee4113a6b8c4926bc7afec3ca5fe5cc178de7de4c23417b8c356ebaefac11



---

# 分页查询看点信息

`taobao.universalbp.new.material.find.spot`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| spot_query_v_o | SpotQueryVO | 是 | 查询对象 | — |
| spot_query_v_o.item_id | Number | 否 | 商品编号 | 38232257688 |
| spot_query_v_o.tag_id | Number | 否 | 业务对象标识 | 40 |
| spot_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2024-08-06 |
| spot_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2024-08-06 |
| spot_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| spot_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_material_find_spot_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_material_find_spot_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_material_find_spot_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_material_find_spot_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_material_find_spot_response.top_result.info.error_code |
| top_result.spot_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data |
| top_result.spot_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.count |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list | SpotVO [] | 未标注 | 列表集合 | — | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].spot_id | Number | 未标注 | 业务对象标识 | 1 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].spot_id |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].material_name | String | 未标注 | 素材名称 | 物料名称 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].material_name |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].title | String | 未标注 | 展示标题 | 物料标题 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].title |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | https://h5.m.taobao.com/****timemove | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].link_url |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | https://img.alicdn.com/******.jpg | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].img_url |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].live_id | Number | 未标注 | 业务对象标识 | 474297730705 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].live_id |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].live_title | String | 未标注 | 业务字段 live_title | 直播间隔一小时抽免单 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].live_title |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].material_id | Number | 未标注 | 素材标识 | 474847464897 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].material_id |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].status | Number | 未标注 | 状态标识 | 4 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].status |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].material_type | Number | 未标注 | 素材类型 | 3 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].material_type |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].audit_reason | String | 未标注 | 业务字段 audit_reason | 1 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].audit_reason |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].material_tag_id | Number | 未标注 | 素材标识 | 40 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].material_tag_id |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].quantity | Number | 未标注 | 业务字段 quantity | 20 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].quantity |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].bid_count | Number | 未标注 | 出价数量 | 20 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].bid_count |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].item_id | Number | 未标注 | 商品编号 | 474847464777 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].item_id |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].outer_status | Number | 未标注 | 业务字段 outer_status | 10 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].outer_status |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].live_cover_img | String | 未标注 | 业务字段 live_cover_img | https://gw.alicdn.com/****.jpg | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].live_cover_img |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].audit_status | Number | 未标注 | 业务字段 audit_status | 1 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].audit_status |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].live_start_time | Date | 未标注 | 业务字段 live_start_time | 2024-08-02 07:44:22 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].live_start_time |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].video_ori_url | String | 未标注 | 业务字段 video_ori_url | https://livecaing.alicdn.com/***** | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].video_ori_url |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].pv | Number | 未标注 | 业务字段 pv | 35 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].pv |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].trade_amt | Number | 未标注 | 业务字段 trade_amt | 147 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].trade_amt |
| top_result.spot_v_o_top_bulk_data.spot_v_o_list[].live_start_time_str | String | 未标注 | 业务字段 live_start_time_str | 2024-08-02 07:44:22 | universalbp_new_material_find_spot_response.top_result.spot_v_o_top_bulk_data.spot_v_o_list.spot_v_o[].live_start_time_str |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.material.find.spot",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "spot_query_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.material.find.spot\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"spot_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：71781f8e5cc162b387c47ac1542098f17510b47aeb50cfbd7a71c262d3af63c0



---

# 设置流量分配

`taobao.universalbp.new.creative.update.rotation`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_command_v_o | CreativeCommandVO | 是 | 创意操作 | — |
| creative_command_v_o.ad_rotation | Number | 否 | 业务字段 ad_rotation；枚举：1=优选、0=轮播） | 0 |
| creative_command_v_o.campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| creative_command_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68793666608 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_update_rotation_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_update_rotation_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_update_rotation_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_update_rotation_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_update_rotation_response.top_result.info.error_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.update.rotation",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "creative_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.creative.update.rotation\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_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 表示业务未完成。

来源校验 SHA256：647351ccac2e5fec88f798b55143ed56a32c5c85cfbe21bf13e2abef4a589193



---

# 屏蔽词查询

`taobao.universalbp.new.blackword.find`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bidword_single_query_v_o | BidwordSingleQueryVO | 是 | 关键词查询对象 | — |
| bidword_single_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 68764632161 |
| bidword_single_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 68805630167 |
| bidword_single_query_v_o.bidword_id | Number | 否 | 关键词标识 | 1131759830446 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_blackword_find_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_blackword_find_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_blackword_find_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_blackword_find_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_blackword_find_response.top_result.info.error_code |
| top_result.black_word_v_o_top_bulk_data | TopBulkData | 未标注 | 词对象 | — | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data |
| top_result.black_word_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.count |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list | BlackWordVO [] | 未标注 | 词列表集合 | — | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 71384876528 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].adgroup_id |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 71310517234 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].campaign_id |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].black_word_id | Number | 未标注 | 词标识 | 1512269026393 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].black_word_id |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].word | String | 未标注 | 词 | 小米连衣裙 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].word |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].match_scope | Number | 未标注 | 业务字段 match_scope | 1 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].match_scope |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].block_query_type | String | 未标注 | 业务字段 block_query_type | OTHER | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].block_query_type |
| top_result.black_word_v_o_top_bulk_data.black_word_v_o_list[].is_high_light | Number | 未标注 | 业务字段 is_high_light | 0 | universalbp_new_blackword_find_response.top_result.black_word_v_o_top_bulk_data.black_word_v_o_list.black_word_v_o[].is_high_light |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.blackword.find",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bidword_single_query_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.blackword.find\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bidword_single_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：412a677f24fc28e96e9d517b3e724b607f4e0bab935edf21ad7c5329cd11a62e



---

# 屏蔽词更新

`taobao.universalbp.new.blackword.update`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| bid_black_word_v_o | BidBlackWordVO | 是 | 出价词对象 | — |
| bid_black_word_v_o.black_word_list | BlackWordCommandVO [] | 否 | 词列表集合 | — |
| bid_black_word_v_o.black_word_list[].op_type | String | 否 | 业务字段 op_type | add |
| bid_black_word_v_o.black_word_list[].campaign_id | Number | 否 | 推广计划编号 | 71310517234 |
| bid_black_word_v_o.black_word_list[].adgroup_id | Number | 否 | 推广单元编号 | 71384876528 |
| bid_black_word_v_o.black_word_list[].word | String | 否 | 词 | 小米连衣裙 |
| bid_black_word_v_o.black_word_list[].match_scope | Number | 否 | 业务字段 match_scope | 1 |
| bid_black_word_v_o.black_word_list[].black_word_id | Number | 否 | 词标识 | 1512269026393 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_blackword_update_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_blackword_update_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_blackword_update_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_blackword_update_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_blackword_update_response.top_result.info.error_code |
| top_result.data | Number | 未标注 | 业务字段 data | 1 | universalbp_new_blackword_update_response.top_result.data |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.blackword.update",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "bid_black_word_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.blackword.update\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"bid_black_word_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 表示业务未完成。

来源校验 SHA256：bab8d58967c16c2dd0ecdaae0bc9101145790432e6614322459fe970611d441d



---

# 查询潜力关键词列表

`taobao.universalbp.new.potential.bidword.find`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| potential_bidword_query_v_o | PotentialBidwordQueryVO | 是 | 关键词查询对象 | — |
| potential_bidword_query_v_o.campaign_id | Number | 否 | 推广计划编号 | 70575863770 |
| potential_bidword_query_v_o.adgroup_id | Number | 否 | 推广单元编号 | 70580701012 |
| potential_bidword_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2024-07-27 |
| potential_bidword_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2024-08-25 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_potential_bidword_find_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_potential_bidword_find_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_potential_bidword_find_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_potential_bidword_find_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_potential_bidword_find_response.top_result.info.error_code |
| top_result.potential_bid_word_v_o_top_bulk_data | TopBulkData | 未标注 | 出价词对象 | — | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data |
| top_result.potential_bid_word_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.count |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list | PotentialBidWordVO [] | 未标注 | 出价词列表集合 | — | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].bidword_pkg_name | String | 未标注 | 业务字段 bidword_pkg_name | 流量智选词包 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].bidword_pkg_name |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 香蕉片 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].original_word |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].bidword_id | Number | 未标注 | 关键词标识 | 1430453211888 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].bidword_id |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 【香蕉片250g】进口香蕉干脆片薄片果干休闲零食特产 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].promotion_name |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 70580701012 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].adgroup_id |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].member_id | Number | 未标注 | 广告账户标识 | 31536383 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].member_id |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].ctr | String | 未标注 | 点击比例 | 0.13103 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].ctr |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].charge | String | 未标注 | 推广花费 | 624.75 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].charge |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].ad_pv | String | 未标注 | 广告展现次数 | 5800.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].ad_pv |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].click | String | 未标注 | 点击次数 | 760.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].click |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].roi | String | 未标注 | 投入产出比 | 4.64844 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].roi |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].cvr | String | 未标注 | 转化比例 | 0.23289 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].cvr |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].ecpc | String | 未标注 | 业务字段 ecpc | 0.82204 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].ecpc |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].col_num | String | 未标注 | 业务字段 col_num | 17.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].col_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | 13.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].item_col_inshop_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | 48.05769 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].item_col_inshop_cost |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | 251.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].cart_inshop_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].col_cart_num | String | 未标注 | 业务字段 col_cart_num | 268.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].col_cart_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].potential_index | String | 未标注 | 业务字段 potential_index | 100.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].potential_index |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | 4.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].shop_col_dir_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].alipay_inshop_num | String | 未标注 | 归因成交数量 | 177.0 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].alipay_inshop_num |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].alipay_inshop_amt | String | 未标注 | 归因成交金额 | 2904.11 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].alipay_inshop_amt |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].is_black_word | Boolean | 未标注 | 业务字段 is_black_word | true | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].is_black_word |
| top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list[].alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | 2904.11 | universalbp_new_potential_bidword_find_response.top_result.potential_bid_word_v_o_top_bulk_data.potential_bid_word_v_o_list.potential_bid_word_v_o[].alipay_dir_amt |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.potential.bidword.find",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "potential_bidword_query_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.potential.bidword.find\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"potential_bidword_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：b5fc79fb9786ac1646385b31b4bf2948fe439582dfe902573cc8bffe98d5ff8e



---

# 批量更新计划卡位方式

`taobao.universalbp.new.campaign.updatedetent`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_detent_command_list_v_o | CampaignDetentCommandListVO | 是 | 计划操作列表对象 | — |
| campaign_detent_command_list_v_o.campaign_detent_update_command_v_o_list | CampaignDetentUpdateCommandVO [] | 否 | 计划操作列表集合 | — |
| campaign_detent_command_list_v_o.campaign_detent_update_command_v_o_list[].campaign_id | Number | 否 | 推广计划编号 | 71310517234 |
| campaign_detent_command_list_v_o.campaign_detent_update_command_v_o_list[].search_detent_type | String | 否 | 业务字段 search_detent_type | third_place |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_updatedetent_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_updatedetent_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_updatedetent_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_updatedetent_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_updatedetent_response.top_result.info.error_code |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

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

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

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


```

## 错误处理

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

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

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

来源校验 SHA256：6f09c7473502043885c25f51055483ac5ba989732617cd3880ff37c2cfa6dd3c



---

# 一键恢复

`taobao.universalbp.new.campaign.onerecover`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| one_click_v_o | OneClickVO | 是 | 业务对象 | — |
| one_click_v_o.item_id_list | Number [] | 否 | 商品标识列表 | [761693282576] |
| one_click_v_o.diff_campaign_list | DiffCampaignVO [] | 否 | 计划列表集合 | — |
| one_click_v_o.diff_campaign_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| one_click_v_o.diff_campaign_list[].material_id_list | Number [] | 否 | 素材标识列表 | [714706341071] |
| one_click_v_o.diff_campaign_list[].diff_campaign_id | Number | 否 | 计划标识 | 71432039559 |
| one_click_v_o.diff_campaign_list[].diff_biz_code | String | 否 | 业务字段 diff_biz_code | onebpSearch |
| one_click_v_o.diff_campaign_list[].diff_real_biz_code | String | 否 | 业务字段 diff_real_biz_code | onebpSearch |
| one_click_v_o.diff_campaign_list[].diff_biz_code_name | String | 否 | 业务字段 diff_biz_code_name | 关键词推广 |
| one_click_v_o.diff_campaign_list[].diff_campaign_name | String | 否 | 业务字段 diff_campaign_name | 关键词推广_20240820_151627 |
| one_click_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| one_click_v_o.campaign_list | DiffCampaignQueryVO [] | 否 | 计划列表 | — |
| one_click_v_o.campaign_list[].campaign_id | Number | 否 | 推广计划编号 | 68792788657 |
| one_click_v_o.campaign_list[].material_id_list | Number [] | 否 | 素材标识列表 | [714706341071] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_onerecover_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_onerecover_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_onerecover_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_onerecover_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_onerecover_response.top_result.info.error_code |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.onerecover\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"one_click_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 表示业务未完成。

来源校验 SHA256：4086b8244bede318eda5ca005193474669b0e13ed1020067945babb9434e5293



---

# 一键暂停

`taobao.universalbp.new.campaign.oneclick`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| one_click_v_o | OneClickVO | 是 | 业务对象 | — |
| one_click_v_o.item_id_list | Number [] | 否 | 商品标识列表 | [761693282576] |
| one_click_v_o.diff_campaign_list | DiffCampaignVO [] | 否 | 计划列表集合 | — |
| one_click_v_o.diff_campaign_list[].campaign_id | Number | 否 | 推广计划编号 | 68796878069 |
| one_click_v_o.diff_campaign_list[].material_id_list | Number [] | 否 | 素材标识列表 | [714706341071] |
| one_click_v_o.diff_campaign_list[].diff_campaign_id | Number | 否 | 计划标识 | 71432039559 |
| one_click_v_o.diff_campaign_list[].diff_biz_code | String | 否 | 业务字段 diff_biz_code | onebpSearch |
| one_click_v_o.diff_campaign_list[].diff_real_biz_code | String | 否 | 业务字段 diff_real_biz_code | onebpSearch |
| one_click_v_o.diff_campaign_list[].diff_biz_code_name | String | 否 | 业务字段 diff_biz_code_name | 关键词推广 |
| one_click_v_o.diff_campaign_list[].diff_campaign_name | String | 否 | 业务字段 diff_campaign_name | 关键词推广_20240820_151627 |
| one_click_v_o.campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| one_click_v_o.campaign_list | DiffCampaignQueryVO [] | 否 | 计划列表 | — |
| one_click_v_o.campaign_list[].campaign_id | Number | 否 | 推广计划编号 | 68792788657 |
| one_click_v_o.campaign_list[].material_id_list | Number [] | 否 | 素材标识列表 | [714706341071] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_oneclick_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_oneclick_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_oneclick_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_oneclick_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_oneclick_response.top_result.info.error_code |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.oneclick\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"one_click_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 表示业务未完成。

来源校验 SHA256：352dc292ffd193a3ee5f139120e1f3d31ec42b420c1d0b0545f8d4b14c55da3c



---

# 查询商品的投放信息

`taobao.universalbp.new.itemcross.promotion.find`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| item_cross_promotion_v_o | ItemCrossPromotionVO | 是 | 商品对象 | — |
| item_cross_promotion_v_o.item_ids | Number [] | 否 | 业务字段 item_ids | [68798644117] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_itemcross_promotion_find_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_itemcross_promotion_find_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_itemcross_promotion_find_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_itemcross_promotion_find_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_itemcross_promotion_find_response.top_result.info.error_code |
| top_result.item_promotion_info_top_bulk_data | TopBulkData | 未标注 | 商品对象 | — | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data |
| top_result.item_promotion_info_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.count |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list | ItemPromotionInfo [] | 未标注 | 商品列表集合 | — | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].online_status | Number | 未标注 | 投放上下线状态 | 1 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].online_status |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].campaign_id |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].item_id | Number | 未标注 | 商品编号 | 752793518760 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].item_id |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].start_time | String | 未标注 | 查询或投放起始时间 | 2024-08-27 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].start_time |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].end_time | String | 未标注 | 查询或投放结束时间 | 2024-08-30 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].end_time |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].roi | String | 未标注 | 投入产出比 | 3 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].roi |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].budget_type | Number | 未标注 | 预算类型 | 1 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].budget_type |
| top_result.item_promotion_info_top_bulk_data.item_promotion_info_list[].budget | String | 未标注 | 预算 | 100 | universalbp_new_itemcross_promotion_find_response.top_result.item_promotion_info_top_bulk_data.item_promotion_info_list.item_promotion_info[].budget |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.itemcross.promotion.find",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "item_cross_promotion_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.itemcross.promotion.find\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"item_cross_promotion_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：b5706d8c9388c5e3c525d858e73c75765b588370229a2648f05723ecead2f195



---

# 横向管理查看资源包列表

`taobao.universalbp.new.adzone.aggregated.findlist`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| adzone_ref_query_v_o | AdzoneRefQueryVO | 是 | 查询对象 | — |
| adzone_ref_query_v_o.campaign_id_list | Number [] | 是 | 计划标识列表 | [68792788657] |
| adzone_ref_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| adzone_ref_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_adzone_aggregated_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_adzone_aggregated_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_adzone_aggregated_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_adzone_aggregated_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_adzone_aggregated_findlist_response.top_result.info.error_code |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data | TopBulkData | 未标注 | 业务对象 | — | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.count |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list | AdzoneRefAggregatedVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].campaign_id |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list | AdzoneRefVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].adzone_id | Number | 未标注 | 业务对象标识 | 111287850198 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].adzone_id |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].adzone_name | String | 未标注 | 业务字段 adzone_name | 全屏微详情 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].adzone_name |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].min_discount | Number | 未标注 | 业务字段 min_discount | 1 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].min_discount |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].max_discount | Number | 未标注 | 业务字段 max_discount | 30 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].max_discount |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].campaign_id |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].campaign_name | String | 未标注 | 推广计划名称 | 管家计划_宝贝候选集 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].campaign_name |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].bid_type | String | 未标注 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比 | max_amount | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].bid_type |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].discount | Number | 未标注 | 出价溢价 | 0 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].discount |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].fit_discount | Number | 未标注 | 业务字段 fit_discount | 0 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].fit_discount |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].status | String | 未标注 | 状态标识；枚举：start=投放、pause=暂停 | start | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].status |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list | OperationVO [] | 未标注 | 列表集合 | — | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].operation_list |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list[].code | String | 未标注 | 结果或业务代码 | 12 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].code |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list[].name | String | 未标注 | 对象名称 | 操作 | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].name |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list[].tips | String | 未标注 | 业务字段 tips | xxxx | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].tips |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list[].disabled | Boolean | 未标注 | 业务字段 disabled | false | universalbp_new_adzone_aggregated_findlist_response.top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list.adzone_ref_aggregated_v_o[].adzone_list.adzone_ref_v_o[].operation_list.operation_v_o[].disabled |
| top_result.adzone_ref_aggregated_v_o_top_bulk_data.adzone_ref_aggregated_v_o_list[].adzone_list[].operation_list[].properties | String | 未标注 | 扩展属性内容 | — | — |

## 核对备注

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

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.adzone.aggregated.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "adzone_ref_query_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.adzone.aggregated.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"adzone_ref_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：e2eab140eb0f228455cbfeb2e982e6ff3e975fbc01ddf13cefb2dbc35b878e0a



---

# 冻结单划拨

`taobao.universalbp.new.campaign.freeze`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_freeze_v_o | CampaignFreezeVO | 是 | 计划对象 | — |
| campaign_freeze_v_o.campaign_id | Number | 否 | 推广计划编号 | 70575863770 |
| campaign_freeze_v_o.coupon_id | Number | 否 | 业务对象标识 | 121528977 |
| campaign_freeze_v_o.terminal_type | String | 否 | 业务字段 terminal_type | PC |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_freeze_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_freeze_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_freeze_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_freeze_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_freeze_response.top_result.info.error_code |
| top_result.order_freeze_result_v_o | OrderFreezeResultVO | 未标注 | 结果对象 | — | universalbp_new_campaign_freeze_response.top_result.order_freeze_result_v_o |
| top_result.order_freeze_result_v_o.success | Boolean | 未标注 | 执行是否成功 | true | universalbp_new_campaign_freeze_response.top_result.order_freeze_result_v_o.success |
| top_result.order_freeze_result_v_o.msg | String | 未标注 | 结果提示 | 成功 | universalbp_new_campaign_freeze_response.top_result.order_freeze_result_v_o.msg |
| top_result.order_freeze_result_v_o.code | String | 未标注 | 结果或业务代码 | PAY_ERROR | universalbp_new_campaign_freeze_response.top_result.order_freeze_result_v_o.code |
| top_result.order_freeze_result_v_o.alipay_url | String | 未标注 | 业务字段 alipay_url | xxxx | universalbp_new_campaign_freeze_response.top_result.order_freeze_result_v_o.alipay_url |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.freeze\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_freeze_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 表示业务未完成。

来源校验 SHA256：1d1110593cda788b187580e18815128292e3930a5795cdff81a4896a0b41c5b1



---

# 手动结束计划(慎用)

`taobao.universalbp.new.campaign.finish`

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

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

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

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_id_v_o | CampaignIdVO | 是 | 计划标识 | — |
| campaign_id_v_o.campaign_id | Number | 是 | 推广计划编号 | 68796878069 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_finish_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_finish_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_finish_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_finish_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_finish_response.top_result.info.error_code |
| top_result.data | Number | 未标注 | 业务字段 data | 1 | universalbp_new_campaign_finish_response.top_result.data |

## 本站请求结构

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

```json

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

```

## Python 调用示例

```python

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

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.finish\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_id_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 表示业务未完成。

来源校验 SHA256：6bc4fb92ca12fe4ef3c1d04ca29bb410d1b8e43cb61a505ad44bcdb6f297c60d



---

# 通用角色查询

`taobao.universalbp.new.check.universal.role`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| universal_merge_role_query_v_o | UniversalMergeRoleQueryVO | 是 | 查询对象 | — |
| universal_merge_role_query_v_o.role_code | String | 否 | 业务字段 role_code；枚举：UNI_MERGE_UTIL_STATIC=无界场景融合升级工具名单、UNI_MERGE_FORBID_EDIT_STATIC=无界场景融合禁编辑名单、UNI_MERGE_FORBID_ADD_STATIC=无界场景融合禁新建名单 | HIT_CROWD_MERGE_ROLE |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_check_universal_role_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_check_universal_role_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_check_universal_role_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_check_universal_role_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_check_universal_role_response.top_result.info.error_code |
| top_result.universal_merge_role_v_o | UniversalMergeRoleVO | 未标注 | 业务对象 | — | universalbp_new_check_universal_role_response.top_result.universal_merge_role_v_o |
| top_result.universal_merge_role_v_o.result_role | Boolean | 未标注 | 业务字段 result_role | true | universalbp_new_check_universal_role_response.top_result.universal_merge_role_v_o.result_role |
| top_result.universal_merge_role_v_o.role_code | String | 未标注 | 业务字段 role_code | HIT_CROWD_MERGE_ROLE | universalbp_new_check_universal_role_response.top_result.universal_merge_role_v_o.role_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.check.universal.role",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "universal_merge_role_query_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.check.universal.role\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"universal_merge_role_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：6ce0f64511dbe4ab9d3814efe70b983f9f4583581fa7939d0f347d7caa3ba924



---

# 实时报表查询(专用,有限制)

`taobao.universalbp.new.report.query.realtime.special`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_real_time_report_query_v_o | TopRealTimeReportQueryVO | 是 | 时间报表查询对象 | — |
| top_real_time_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_real_time_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_real_time_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_real_time_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| top_real_time_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-06 |
| top_real_time_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| top_real_time_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [campaign， date] |
| top_real_time_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_real_time_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_real_time_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_real_time_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_real_time_report_query_v_o.source_list | String [] | 否 | 业务条件集合 | ["SCENE"] |
| top_real_time_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_real_time_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_real_time_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_realtime_special_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_realtime_special_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_realtime_special_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_realtime_special_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions | TopPromotionVO [] | 未标注 | 业务集合 | — | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_id | Number | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type | 11 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type_str | String | 未标注 | 业务字段 sub_promotion_type_str | ITEM | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type_str |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_roi | String | 未标注 | 业务字段 retained_roi | xxxxx | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_alipay_inshop_amt | String | 未标注 | 业务字段 retained_alipay_inshop_amt | 100.00 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt_net | String | 未标注 | 业务字段 alipay_dir_amt_net | 80.00 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt_net |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_alipay_inshop_amt_rate | String | 未标注 | 业务字段 retained_alipay_inshop_amt_rate | 0.85 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_alipay_inshop_amt_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt_net_rate | String | 未标注 | 业务字段 alipay_dir_amt_net_rate | 0.72 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt_net_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_alipay_inshop_num | String | 未标注 | 业务字段 retained_alipay_inshop_num | 15 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num_net | String | 未标注 | 业务字段 alipay_dir_num_net | 12 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num_net |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_and_retained_dir_roi | String | 未标注 | 业务字段 prepay_and_retained_dir_roi | 3.5 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_and_retained_dir_roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.dir_net_roi | String | 未标注 | 业务字段 dir_net_roi | 2.8 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.dir_net_roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_and_retained_roi | String | 未标注 | 业务字段 prepay_and_retained_roi | 3.2 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_and_retained_roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_prepay_inshop_roi | String | 未标注 | 业务字段 alipay_prepay_inshop_roi | 4.0 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_prepay_inshop_roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_prepay_dir_inshop_roi | String | 未标注 | 业务字段 alipay_prepay_dir_inshop_roi | 3.6 | universalbp_new_report_query_realtime_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_prepay_dir_inshop_roi |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.realtime.special",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_real_time_report_query_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.report.query.realtime.special\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_real_time_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：56fb6fbd1b68959b0343cf50993f05f5cf35848689e1eae76a5bce6c0235f1f1



---

# 更新素材有效时间

`taobao.universalbp.new.creative.update.material.time`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| material_command_v_o | MaterialCommandVO | 是 | 素材操作 | — |
| material_command_v_o.creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| material_command_v_o.material_ids | Number [] | 否 | 业务字段 material_ids | [68520441058] |
| material_command_v_o.material_id | Number | 否 | 素材标识 | 68520441058 |
| material_command_v_o.start_time | Date | 否 | 查询或投放起始时间 | 2024-10-22 15:49:05 |
| material_command_v_o.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:01 |
| material_command_v_o.material_name | String | 否 | 素材名称 | 主图_宝贝82840187523 |
| material_command_v_o.unlimited | Number | 否 | 业务字段 unlimited | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_update_material_time_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_update_material_time_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_update_material_time_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_update_material_time_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_update_material_time_response.top_result.info.error_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.creative.update.material.time",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "material_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.creative.update.material.time\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"material_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 表示业务未完成。

来源校验 SHA256：2a9ac0ea84bf60795bc29695dacb09bf9a2505d2972452108d855283ab82f605



---

# 更新素材信息(更新素材名称)

`taobao.universalbp.new.creative.update.material`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| creative_material_v_o | CreativeMaterialVO | 是 | 创意素材 | — |
| creative_material_v_o.material_list | MaterialCommandVO [] | 否 | 素材列表 | — |
| creative_material_v_o.material_list[].creative_id | Number | 否 | 广告创意编号 | 6843262308 |
| creative_material_v_o.material_list[].material_ids | Number [] | 否 | 业务字段 material_ids | [68520441058] |
| creative_material_v_o.material_list[].material_id | Number | 否 | 素材标识 | 68520441058 |
| creative_material_v_o.material_list[].start_time | Date | 否 | 查询或投放起始时间 | 2024-10-22 15:49:05 |
| creative_material_v_o.material_list[].end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:01 |
| creative_material_v_o.material_list[].material_name | String | 否 | 素材名称 | 主图_宝贝82840187523 |
| creative_material_v_o.material_list[].unlimited | Number | 否 | 业务字段 unlimited | 1 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_creative_update_material_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_creative_update_material_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_creative_update_material_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_creative_update_material_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_creative_update_material_response.top_result.info.error_code |
| top_result.top_part_data | TopPartData | 未标注 | 业务对象 | — | universalbp_new_creative_update_material_response.top_result.top_part_data |
| top_result.top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_creative_update_material_response.top_result.top_part_data.count |
| top_result.top_part_data.data_list | String [] | 未标注 | 业务条件集合 | 10,20 | universalbp_new_creative_update_material_response.top_result.top_part_data.data_list |
| top_result.top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_creative_update_material_response.top_result.top_part_data.error_count |
| top_result.top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_creative_update_material_response.top_result.top_part_data.error_details |
| top_result.top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_creative_update_material_response.top_result.top_part_data.error_details.top_fail_result[].code |
| top_result.top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_creative_update_material_response.top_result.top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

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

```json

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

来源校验 SHA256：f7baf2586499ffadafb5cca940a146fa8d26cddd7e87ff2ece7faaa55afa8c1a



---

# 市场趋势-通过词取相关类目

`taobao.universalbp.new.word.gategory.find`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_category_query_v_o | WordCategoryQueryVO | 是 | 词查询对象 | — |
| word_category_query_v_o.biz_code | String | 否 | 推广场景标识 | universalBP |
| word_category_query_v_o.original_word_list | String [] | 否 | 词集合 | ["裙子"] |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_word_gategory_find_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_word_gategory_find_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_word_gategory_find_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_word_gategory_find_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_word_gategory_find_response.top_result.info.error_code |
| top_result.word_category_result_v_o_top_bulk_data | TopBulkData | 未标注 | 词结果对象 | — | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data |
| top_result.word_category_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.count |
| top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list | WordCategoryResultVO [] | 未标注 | 词结果列表集合 | — | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list |
| top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list[].category_list | CategoryVO [] | 未标注 | 列表集合 | — | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list.word_category_result_v_o[].category_list |
| top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list[].category_list[].cate_id | Number | 未标注 | 业务对象标识 | 50010850 | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list.word_category_result_v_o[].category_list.category_v_o[].cate_id |
| top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list[].category_list[].cate_name | String | 未标注 | 业务字段 cate_name | 女装/女士精品 连衣裙 | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list.word_category_result_v_o[].category_list.category_v_o[].cate_name |
| top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list[].word | String | 未标注 | 词 | 裙子 | universalbp_new_word_gategory_find_response.top_result.word_category_result_v_o_top_bulk_data.word_category_result_v_o_list.word_category_result_v_o[].word |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.word.gategory.find",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_category_query_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.word.gategory.find\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_category_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：f35877144bd8fe7dc299eb5c148af6df90411103647a1bfb113d8351a8e1cdaa



---

# 市场趋势-指标分日详情

`taobao.universalbp.new.word.index.detail`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| word_index_query_v_o | WordIndexQueryVO | 是 | 词查询对象 | — |
| word_index_query_v_o.start_time | String | 否 | 查询或投放起始时间；开始时间_必填 | 2024-11-09 |
| word_index_query_v_o.end_time | String | 否 | 查询或投放结束时间；结束时间_必填 | 2024-12-08 |
| word_index_query_v_o.word_category_list | WordCategoryVO [] | 否 | 词列表集合 | — |
| word_index_query_v_o.word_category_list[].cate_id | Number | 否 | 业务对象标识；类目id_必填 | 50010850 |
| word_index_query_v_o.word_category_list[].word | String | 否 | 词；词_必填 | 裙子 |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_word_index_detail_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_word_index_detail_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_word_index_detail_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_word_index_detail_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_word_index_detail_response.top_result.info.error_code |
| top_result.word_index_detail_v_o_top_bulk_data | TopBulkData | 未标注 | 词对象 | — | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data |
| top_result.word_index_detail_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.count |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list | WordIndexDetailVO [] | 未标注 | 词列表集合 | — | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].word | String | 未标注 | 词 | 裙子 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].word |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].the_date | String | 未标注 | 业务字段 the_date | 2024-11-22 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].the_date |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].impression_index | String | 未标注 | 业务字段 impression_index | 1233 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].impression_index |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].click_index | String | 未标注 | 业务字段 click_index | 32 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].click_index |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].ctr | String | 未标注 | 点击比例 | 0.02 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].ctr |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].cvr | String | 未标注 | 转化比例 | 0.02 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].cvr |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].competition_index | String | 未标注 | 业务字段 competition_index | 443 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].competition_index |
| top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list[].avg_price | String | 未标注 | 业务字段 avg_price | 1.323 | universalbp_new_word_index_detail_response.top_result.word_index_detail_v_o_top_bulk_data.word_index_detail_v_o_list.word_index_detail_v_o[].avg_price |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.word.index.detail",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "word_index_query_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.word.index.detail\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"word_index_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：bbb393a1dbbaa300066f8af0b92e73f2cfb5f879448e2173e92eef282640be27



---

# 签署协议

`taobao.universalbp.new.member.sign.protocol`

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

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| protocol_v_o | ProtocolVO | 是 | 业务对象 | — |
| protocol_v_o.protocol_code | String | 否 | 业务字段 protocol_code | xxxxx |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_member_sign_protocol_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_member_sign_protocol_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_member_sign_protocol_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_member_sign_protocol_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_member_sign_protocol_response.top_result.info.error_code |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.member.sign.protocol",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "protocol_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.member.sign.protocol\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"protocol_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 表示业务未完成。

来源校验 SHA256：4579a2fde4d7fd91e46c1b05c028723269db6e74981f1186f222e7fcb7788ad7



---

# 是否已签署协议

`taobao.universalbp.new.member.judge.signprotocol`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| protocol_v_o | ProtocolVO | 是 | 业务对象 | — |
| protocol_v_o.protocol_code | String | 否 | 业务字段 protocol_code | xxxxx |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_member_judge_signprotocol_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_member_judge_signprotocol_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_member_judge_signprotocol_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_member_judge_signprotocol_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_member_judge_signprotocol_response.top_result.info.error_code |
| top_result.protocol_sign_v_o | ProtocolSignVO | 未标注 | 业务对象 | — | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o |
| top_result.protocol_sign_v_o.is_sign_protocol | Boolean | 未标注 | 业务字段 is_sign_protocol | false | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.is_sign_protocol |
| top_result.protocol_sign_v_o.protocol_code | String | 未标注 | 业务字段 protocol_code | xxxxx | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.protocol_code |
| top_result.protocol_sign_v_o.is_read_only | Boolean | 未标注 | 业务字段 is_read_only | false | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.is_read_only |
| top_result.protocol_sign_v_o.sign_tips | String | 未标注 | 业务字段 sign_tips | xxxxx | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.sign_tips |
| top_result.protocol_sign_v_o.protocol_link | String | 未标注 | 业务字段 protocol_link | https://terms.alicdn.comxxxxx | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.protocol_link |
| top_result.protocol_sign_v_o.protocol_name | String | 未标注 | 业务字段 protocol_name | 充值协议 | universalbp_new_member_judge_signprotocol_response.top_result.protocol_sign_v_o.protocol_name |

## 本站请求结构

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

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.member.judge.signprotocol",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "protocol_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.member.judge.signprotocol\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"protocol_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：a8bcecbd341560ce6560ac823492ad1d8295248a2a205fc7628df7a8e9f8acbc



---

# 是否已签署无界协议

`taobao.universalbp.new.member.judge.sign.bp.protocol`

核对日期：2026-09-19；类型：查询操作。

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

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

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |

## 响应业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_member_judge_sign_bp_protocol_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_member_judge_sign_bp_protocol_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_member_judge_sign_bp_protocol_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_member_judge_sign_bp_protocol_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_member_judge_sign_bp_protocol_response.top_result.info.error_code |
| top_result.protocol_sign_v_o | ProtocolSignVO | 未标注 | 业务对象 | — | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o |
| top_result.protocol_sign_v_o.is_sign_protocol | Boolean | 未标注 | 业务字段 is_sign_protocol | false | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.is_sign_protocol |
| top_result.protocol_sign_v_o.protocol_code | String | 未标注 | 业务字段 protocol_code | xxxxx | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.protocol_code |
| top_result.protocol_sign_v_o.is_read_only | Boolean | 未标注 | 业务字段 is_read_only | false | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.is_read_only |
| top_result.protocol_sign_v_o.sign_tips | String | 未标注 | 业务字段 sign_tips | xxxxx | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.sign_tips |
| top_result.protocol_sign_v_o.protocol_link | String | 未标注 | 业务字段 protocol_link | https://terms.alicdn.comxxxxx | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.protocol_link |
| top_result.protocol_sign_v_o.protocol_name | String | 未标注 | 业务字段 protocol_name | 充值协议 | universalbp_new_member_judge_sign_bp_protocol_response.top_result.protocol_sign_v_o.protocol_name |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.member.judge.sign.bp.protocol",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    }
  }
}

```

## 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.member.judge.sign.bp.protocol\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：54bf22db2a93eadd92f58fc2e11620cfec8f67dcd1a62e87d210881c08c4633c



---

# 批量更新计划出价

`taobao.universalbp.new.campaign.onebpsearch.batchupdate`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=71474)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 JSON 的 params 内。必填列保留官方标注；官方未标注的内容不推定为必填或可选。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_bid_list_v_o | CampaignBidListVO | 是 | 计划出价列表 | — |
| campaign_bid_list_v_o.bid_list | CampaignBidCommandVO [] | 是 | 出价列表 | — |
| campaign_bid_list_v_o.bid_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、pe=控成本、roi_control=控投产比 | max_amount |
| campaign_bid_list_v_o.bid_list[].cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| campaign_bid_list_v_o.bid_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| campaign_bid_list_v_o.bid_list[].constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| campaign_bid_list_v_o.bid_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| campaign_bid_list_v_o.bid_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_list_v_o.bid_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_bid_list_v_o.bid_list[].crowd_discount | Number | 否 | 业务字段 crowd_discount | 30 |
| campaign_bid_list_v_o.bid_list[].word_price | String | 否 | 词金额 | 30 |
| campaign_bid_list_v_o.bid_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_bid_list_v_o.bid_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_bid_list_v_o.bid_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |

## 响应业务字段

TOP 响应外层：`universalbp_new_campaign_onebpsearch_batchupdate_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.error_code |
| top_result.campaign_bid_update_result_v_o_top_part_data | TopPartData | 未标注 | 计划出价结果对象 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data |
| top_result.campaign_bid_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.count |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list | CampaignBidUpdateResultVO [] | 未标注 | 计划出价结果列表集合 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list.campaign_bid_update_result_v_o[].campaign_id |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_count |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result | CampaignBidUpdateResultVO | 未标注 | 执行结果内容 | — | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result.campaign_id |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.onebpsearch.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_bid_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.onebpsearch.batchupdate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_bid_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.campaign_bid_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：6ba772727c33834a7cda8af2b2372063597ca0be29240cc0942f26730156afdb



---

# 批量更新计划出价

`taobao.universalbp.new.campaign.onebpsite.batchupdate`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=71475)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 JSON 的 params 内。必填列保留官方标注；官方未标注的内容不推定为必填或可选。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_bid_list_v_o | CampaignBidListVO | 是 | 计划出价列表 | — |
| campaign_bid_list_v_o.bid_list | CampaignBidCommandVO [] | 是 | 出价列表 | — |
| campaign_bid_list_v_o.bid_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、pe=控成本、roi_control=控投产比 | max_amount |
| campaign_bid_list_v_o.bid_list[].cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| campaign_bid_list_v_o.bid_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| campaign_bid_list_v_o.bid_list[].constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| campaign_bid_list_v_o.bid_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| campaign_bid_list_v_o.bid_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_list_v_o.bid_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_bid_list_v_o.bid_list[].crowd_discount | Number | 否 | 业务字段 crowd_discount | 30 |
| campaign_bid_list_v_o.bid_list[].word_price | String | 否 | 词金额 | 30 |
| campaign_bid_list_v_o.bid_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_bid_list_v_o.bid_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_bid_list_v_o.bid_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |

## 响应业务字段

TOP 响应外层：`universalbp_new_campaign_onebpsite_batchupdate_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.info.error_code |
| top_result.campaign_bid_update_result_v_o_top_part_data | TopPartData | 未标注 | 计划出价结果对象 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data |
| top_result.campaign_bid_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.count |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list | CampaignBidUpdateResultVO [] | 未标注 | 计划出价结果列表集合 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list.campaign_bid_update_result_v_o[].campaign_id |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_count |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result | CampaignBidUpdateResultVO | 未标注 | 执行结果内容 | — | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result.campaign_id |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.onebpsite.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_bid_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.onebpsite.batchupdate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_bid_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.campaign_bid_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_onebpsite_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：9ca0b395f50dcf578bdfc95099ccb5a2f19fe4f6acab23de51d0e6408793cf60



---

# 批量更新计划出价

`taobao.universalbp.new.campaign.onebpdisplay.batchupdate`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=71476)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 JSON 的 params 内。必填列保留官方标注；官方未标注的内容不推定为必填或可选。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_bid_list_v_o | CampaignBidListVO | 是 | 计划出价列表 | — |
| campaign_bid_list_v_o.bid_list | CampaignBidCommandVO [] | 是 | 出价列表 | — |
| campaign_bid_list_v_o.bid_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、pe=控成本、roi_control=控投产比 | max_amount |
| campaign_bid_list_v_o.bid_list[].cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| campaign_bid_list_v_o.bid_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| campaign_bid_list_v_o.bid_list[].constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| campaign_bid_list_v_o.bid_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| campaign_bid_list_v_o.bid_list[].campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| campaign_bid_list_v_o.bid_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_list_v_o.bid_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_list_v_o.bid_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_list_v_o.bid_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_bid_list_v_o.bid_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_bid_list_v_o.bid_list[].crowd_discount | Number | 否 | 业务字段 crowd_discount | 30 |
| campaign_bid_list_v_o.bid_list[].word_price | String | 否 | 词金额 | 30 |
| campaign_bid_list_v_o.bid_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_bid_list_v_o.bid_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_bid_list_v_o.bid_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |

## 响应业务字段

TOP 响应外层：`universalbp_new_campaign_onebpdisplay_batchupdate_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.info.error_code |
| top_result.campaign_bid_update_result_v_o_top_part_data | TopPartData | 未标注 | 计划出价结果对象 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data |
| top_result.campaign_bid_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.count |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list | CampaignBidUpdateResultVO [] | 未标注 | 计划出价结果列表集合 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list |
| top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list.campaign_bid_update_result_v_o[].campaign_id |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_count |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result | CampaignBidUpdateResultVO | 未标注 | 执行结果内容 | — | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result |
| top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result.campaign_id | Number | 未标注 | 推广计划编号 | 68796878069 | universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result.campaign_id |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.onebpdisplay.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_bid_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.onebpdisplay.batchupdate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_bid_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.campaign_bid_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_onebpdisplay_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：e3a5162737680981276579e1a0ccfb3c1615022bbb72a662555712c44b090ddf



---

# 成效预估(专用-权限限制)

`taobao.universalbp.new.algo.geteffectprediction.special`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=71892)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| algo_query_v_o | AlgoQueryVO | 是 | 查询对象 | — |
| algo_query_v_o.campaign | AlgoCampaignQueryVO | 否 | 计划 | — |
| algo_query_v_o.campaign.campaign_id | Number | 否 | 推广计划编号 | 68799007001 |
| algo_query_v_o.campaign.promotion_model | String | 否 | 业务字段 promotion_model | display |
| algo_query_v_o.campaign.promotion_scene | String | 否 | 业务字段 promotion_scene | promotion_scene_crowd |
| algo_query_v_o.campaign.similar_item_strategy | String | 否 | 业务字段 similar_item_strategy | new_ad_similar |
| algo_query_v_o.campaign.promotion_goals | String | 否 | 业务字段 promotion_goals | shop_crowd |
| algo_query_v_o.campaign.optimize_target | String | 否 | 优化目标 | shop_visit_new |
| algo_query_v_o.campaign.dmc_type | String | 否 | 预算方式标识 | normal |
| algo_query_v_o.campaign.day_budget | Number | 否 | 日预算 | 60 |
| algo_query_v_o.campaign.reap_all_budget | Number | 否 | 业务字段 reap_all_budget | 60 |
| algo_query_v_o.campaign.old_budget | Number | 否 | 业务字段 old_budget | 500 |
| algo_query_v_o.campaign.total_budget | Number | 否 | 累计预算 | 350 |
| algo_query_v_o.campaign.day_average_budget | Number | 否 | 业务字段 day_average_budget | 50 |
| algo_query_v_o.campaign.budget_period | Number | 否 | 业务字段 budget_period | 1 |
| algo_query_v_o.campaign.bid_type | String | 否 | 出价类型 | roi_control |
| algo_query_v_o.campaign.constraint_type | String | 否 | 业务字段 constraint_type | roi |
| algo_query_v_o.campaign.constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| algo_query_v_o.campaign.old_constraint_value | String | 否 | 业务字段 old_constraint_value | 2.5 |
| algo_query_v_o.campaign.promotion_type | String | 否 | 业务字段 promotion_type | item |
| algo_query_v_o.campaign.item_selected_mode | String | 否 | 业务字段 item_selected_mode | user_define |
| algo_query_v_o.campaign.item_rec_strategy | String [] | 否 | 业务字段 item_rec_strategy | ["effect_gmv","effect_coll"] |
| algo_query_v_o.campaign.is_quick_lift | Boolean | 否 | 业务字段 is_quick_lift | true |
| algo_query_v_o.campaign.quick_lift_budget_command | CampaignQuickLiftCommandVO | 否 | 预算操作对象 | — |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_switch | Boolean | 否 | 业务字段 quick_lift_switch；枚举：true=打开、false=关闭 | true |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget | String | 否 | 业务字段 quick_lift_budget | 50 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot | String | 否 | 业务字段 quick_lift_time_slot | 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_list | String [] | 否 | 地域集合 | all:全部地域;[19, 532, 471, 463, 577, 599, 576, 531, 575]:自定义选择地域 |
| algo_query_v_o.campaign.quick_lift_budget_command.quick_lift_budget_version | String | 否 | 业务字段 quick_lift_budget_version | 1 |
| algo_query_v_o.campaign.adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| algo_query_v_o.campaign.adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| algo_query_v_o.campaign.adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| algo_query_v_o.campaign.crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| algo_query_v_o.campaign.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| algo_query_v_o.campaign.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| algo_query_v_o.campaign.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| algo_query_v_o.campaign.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| algo_query_v_o.campaign.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| algo_query_v_o.campaign.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| algo_query_v_o.campaign.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| algo_query_v_o.campaign.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| algo_query_v_o.campaign.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| algo_query_v_o.campaign.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| algo_query_v_o.campaign.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| algo_query_v_o.campaign.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| algo_query_v_o.campaign.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| algo_query_v_o.campaign.launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| algo_query_v_o.campaign.launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |
| algo_query_v_o.campaign.launch_area_str_list | String [] | 否 | 地域集合 | ["all"] |
| algo_query_v_o.campaign.launch_time | CampaignLaunchTimeCommandVO | 否 | 时间对象 | — |
| algo_query_v_o.campaign.launch_time.start_time | Date | 否 | 查询或投放起始时间 | 2023-06-09 00:00:00 |
| algo_query_v_o.campaign.launch_time.end_time | Date | 否 | 查询或投放结束时间 | 2199-02-01 00:00:00 |
| algo_query_v_o.campaign.launch_time.launch_forever | Boolean | 否 | 业务字段 launch_forever；枚举：true=是、false=否 | true |
| algo_query_v_o.campaign.word_list | WordCommandVO [] | 否 | 词列表 | — |
| algo_query_v_o.campaign.word_list[].bidword_id | Number | 否 | 关键词标识；关键词已经存在场景必填 | 1124844766581 |
| algo_query_v_o.campaign.word_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| algo_query_v_o.campaign.word_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68793666608 |
| algo_query_v_o.campaign.word_list[].word | String | 否 | 词 | 鞋原创小众 |
| algo_query_v_o.campaign.word_list[].bid_price | String | 否 | 出价金额 | 2.23 |
| algo_query_v_o.campaign.word_list[].suggest_trace_id | String | 否 | 建议标识 | xxxxx |
| algo_query_v_o.campaign.word_list[].online_status | Number | 否 | 投放上下线状态；枚举：1=在线、0=下线 | 1 |
| algo_query_v_o.campaign.word_list[].match_scope | Number | 否 | 业务字段 match_scope；枚举：1=精准匹配、4=广泛匹配 | 4 |
| algo_query_v_o.campaign.search_upgrade_pxb | Number | 否 | 业务字段 search_upgrade_pxb | 0 |
| algo_query_v_o.campaign.need_target_crowd | Number | 否 | 业务字段 need_target_crowd | 1 |
| algo_query_v_o.campaign.algo_prediction_extra_info | String | 否 | 业务字段 algo_prediction_extra_info | {} |
| algo_query_v_o.campaign.bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| algo_query_v_o.campaign.bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| algo_query_v_o.campaign.set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| algo_query_v_o.campaign.promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| algo_query_v_o.campaign.majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| algo_query_v_o.campaign.user_type | Number | 否 | 业务字段 user_type | 10 |
| algo_query_v_o.campaign.is_multi_target | Boolean | 否 | 业务字段 is_multi_target | true |
| algo_query_v_o.campaign.multi_target | CampaignMultiTargetVO | 否 | 目标对象 | — |
| algo_query_v_o.campaign.multi_target.multi_target_switch | Number | 否 | 业务字段 multi_target_switch；枚举：0=关闭、1=开启 | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_source_type | Number | 否 | 业务字段 multi_target_source_type | 1 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list | CampaignMultiTargetConfigVO [] | 否 | 目标列表集合 | — |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].optimize_target | String | 否 | 优化目标 | 1034 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget | String | 否 | 业务字段 multi_target_budget | 1000 |
| algo_query_v_o.campaign.multi_target.multi_target_config_list[].multi_target_defined_max_rate | Number | 否 | 业务字段 multi_target_defined_max_rate | 50 |
| algo_query_v_o.adgroup_list | AlgoAdgroupQueryVO [] | 否 | 单元列表 | — |
| algo_query_v_o.adgroup_list[].material | AdgroupMaterialCommandVO | 否 | 素材 | — |
| algo_query_v_o.adgroup_list[].material.material_id | Number | 否 | 素材标识 | 714616513841 |
| algo_query_v_o.adgroup_list[].material.material_name | String | 否 | 素材名称 | yiliantest测试请不要拍22 |
| algo_query_v_o.adgroup_list[].material.promotion_type | String | 否 | 业务字段 promotion_type；枚举：item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
| algo_query_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 |
| algo_query_v_o.adgroup_list[].material.link_url | String | 否 | 业务字段 link_url | http://shop191070507.taobao.com/index.htm |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list | ItemLifeCycleViewVO [] | 否 | 列表集合 | — |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].life_cycle_desc | String | 否 | 业务字段 life_cycle_desc | 新品打爆期 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].color | String | 否 | 业务字段 color | #36A2FC |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].tips | String | 否 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
| algo_query_v_o.adgroup_list[].material.goal_life_cycle_list[].type | Number | 否 | 类型 | 1 |
| algo_query_v_o.effect_type_list | String [] | 否 | 类型集合 | ["gmv"] |
| algo_query_v_o.dmc_type_element | String | 否 | 业务字段 dmc_type_element | dayBudget |

## 响应业务字段

TOP 响应外层：`universalbp_new_algo_geteffectprediction_special_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_algo_geteffectprediction_special_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_algo_geteffectprediction_special_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_algo_geteffectprediction_special_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_algo_geteffectprediction_special_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_algo_geteffectprediction_special_response.top_result.info.error_code |
| top_result.effect_predict_v_o | EffectPredictVO | 未标注 | 业务对象 | — | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o |
| top_result.effect_predict_v_o.pv | Number | 未标注 | 业务字段 pv | 1621 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv |
| top_result.effect_predict_v_o.pv_low | Number | 未标注 | 业务字段 pv_low | 1297 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv_low |
| top_result.effect_predict_v_o.pv_high | Number | 未标注 | 业务字段 pv_high | 1945 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.pv_high |
| top_result.effect_predict_v_o.click | Number | 未标注 | 点击次数 | 97 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click |
| top_result.effect_predict_v_o.click_low | Number | 未标注 | 业务字段 click_low | 78 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click_low |
| top_result.effect_predict_v_o.click_high | Number | 未标注 | 业务字段 click_high | 117 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.click_high |
| top_result.effect_predict_v_o.conv | Number | 未标注 | 业务字段 conv | 13 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv |
| top_result.effect_predict_v_o.conv_low | Number | 未标注 | 业务字段 conv_low | 10 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv_low |
| top_result.effect_predict_v_o.conv_high | Number | 未标注 | 业务字段 conv_high | 15 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.conv_high |
| top_result.effect_predict_v_o.wconv | Number | 未标注 | 业务字段 wconv | 27 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv |
| top_result.effect_predict_v_o.wconv_low | Number | 未标注 | 业务字段 wconv_low | 22 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv_low |
| top_result.effect_predict_v_o.wconv_high | Number | 未标注 | 业务字段 wconv_high | 33 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.wconv_high |
| top_result.effect_predict_v_o.mem | Number | 未标注 | 业务字段 mem | 0 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem |
| top_result.effect_predict_v_o.mem_low | Number | 未标注 | 业务字段 mem_low | 0 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem_low |
| top_result.effect_predict_v_o.mem_high | Number | 未标注 | 业务字段 mem_high | 1 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.mem_high |
| top_result.effect_predict_v_o.cost | String | 未标注 | 业务字段 cost；计量单位：元 | 823.83 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost |
| top_result.effect_predict_v_o.cost_low | String | 未标注 | 业务字段 cost_low；计量单位：元 | 659.06 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost_low |
| top_result.effect_predict_v_o.cost_high | String | 未标注 | 业务字段 cost_high；计量单位：元 | 988.60 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cost_high |
| top_result.effect_predict_v_o.cart | Number | 未标注 | 业务字段 cart | 10 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart |
| top_result.effect_predict_v_o.cart_low | Number | 未标注 | 业务字段 cart_low | 5 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart_low |
| top_result.effect_predict_v_o.cart_high | Number | 未标注 | 业务字段 cart_high | 15 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.cart_high |
| top_result.effect_predict_v_o.uv_aim_low | Number | 未标注 | 业务字段 uv_aim_low | 5 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.uv_aim_low |
| top_result.effect_predict_v_o.uv_aim_high | Number | 未标注 | 业务字段 uv_aim_high | 15 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.uv_aim_high |
| top_result.effect_predict_v_o.gmv | String | 未标注 | 业务字段 gmv | 6845.21 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv |
| top_result.effect_predict_v_o.gmv_net | String | 未标注 | 业务字段 gmv_net | 6845.21 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_net |
| top_result.effect_predict_v_o.gmv_low | String | 未标注 | 业务字段 gmv_low | 5476.17 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_low |
| top_result.effect_predict_v_o.gmv_high | String | 未标注 | 业务字段 gmv_high | 8214.26 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_high |
| top_result.effect_predict_v_o.gmv_low_net | String | 未标注 | 业务字段 gmv_low_net | 5476.17 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_low_net |
| top_result.effect_predict_v_o.gmv_high_net | String | 未标注 | 业务字段 gmv_high_net | 8214.26 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_high_net |
| top_result.effect_predict_v_o.min_gmv | String | 未标注 | 业务字段 min_gmv | 5476.17 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.min_gmv |
| top_result.effect_predict_v_o.max_gmv | String | 未标注 | 业务字段 max_gmv | 8214.26 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.max_gmv |
| top_result.effect_predict_v_o.success_ratio_high | String | 未标注 | 业务字段 success_ratio_high | 0.9 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.success_ratio_high |
| top_result.effect_predict_v_o.success_ratio_low | String | 未标注 | 业务字段 success_ratio_low | 0.8 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.success_ratio_low |
| top_result.effect_predict_v_o.gmv_diff_percent | String | 未标注 | 业务字段 gmv_diff_percent | 0.67 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.gmv_diff_percent |
| top_result.effect_predict_v_o.effect_predict_reason | String | 未标注 | 业务字段 effect_predict_reason | 预计曝光量<span number=\"highlight\">+20%</span>，自然流量助推<span number=\"error\">+10%</span> | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.effect_predict_reason |
| top_result.effect_predict_v_o.reason | String | 未标注 | 业务字段 reason | 预计可获得点击量2次 | universalbp_new_algo_geteffectprediction_special_response.top_result.effect_predict_v_o.reason |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.algo.geteffectprediction.special",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "algo_query_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.algo.geteffectprediction.special\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"algo_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：011243a47375594673326220b336103419b6fe032a4068bf7037af5d9e72f205



---

# 计划报表查询(专用-权限限制)

`taobao.universalbp.new.report.query.campaign.special`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=71893)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_campaign_report_query_v_o | TopCampaignReportQueryVO | 是 | 计划报表查询 | — |
| top_campaign_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_campaign_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_campaign_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_campaign_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_campaign_report_query_v_o.start_time | String | 是 | 查询或投放起始时间 | 2023-06-06 |
| top_campaign_report_query_v_o.end_time | String | 是 | 查询或投放结束时间 | 2023-06-12 |
| top_campaign_report_query_v_o.effect_equal | Number | 是 | 转化统计窗口 | 15 |
| top_campaign_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [date, campaign] |
| top_campaign_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_campaign_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_campaign_report_query_v_o.strategy_optimize_target_in_list | Number [] | 否 | 优化目标集合 | [3003] |
| top_campaign_report_query_v_o.strategy_campaign_id_or_name | String | 否 | 业务字段 strategy_campaign_id_or_name | 测试计划 |
| top_campaign_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合 | [68798644117] |
| top_campaign_report_query_v_o.item_id_or_name | String | 否 | 业务字段 item_id_or_name | 连衣裙长裙 |
| top_campaign_report_query_v_o.province_id_in_list | Number [] | 否 | 标识集合 | [1] |
| top_campaign_report_query_v_o.strategy_promotion_mode_in_list | String [] | 否 | 业务条件集合 | daily |
| top_campaign_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_campaign_report_query_v_o.strategy_str_dmc_type_in_list | String [] | 否 | 类型集合 | 1 |
| top_campaign_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_campaign_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |

## 响应业务字段

TOP 响应外层：`universalbp_new_report_query_campaign_special_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_campaign_special_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_campaign_special_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_campaign_special_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_campaign_special_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_scene_name | String | 未标注 | 业务字段 original_scene_name | 人群推广 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_scene_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_biz_code | String | 未标注 | 业务字段 original_biz_code | onebpDisplay | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions | TopPromotionVO [] | 未标注 | 业务集合 | — | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].promotion_id | Number | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type | String | 未标注 | 业务字段 sub_promotion_type | 11 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotions[].sub_promotion_type_str | String | 未标注 | 业务字段 sub_promotion_type_str | ITEM | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotions.top_promotion_v_o[].sub_promotion_type_str |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_campaign_special_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.campaign.special",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_campaign_report_query_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.report.query.campaign.special\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_campaign_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：d35345b5fec0f060cdd7fe8d72be7fd6cb275a365a9621ef06cd2ee4d55221a1



---

# 查询推荐模板

`taobao.universalbp.new.template.getsuggest`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=72093)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| tetris_template_query_v_o | TetrisTemplateQueryVO | 是 | 模板查询对象 | — |
| tetris_template_query_v_o.template_type | String | 是 | 模板类型 | AREA |

## 响应业务字段

TOP 响应外层：`universalbp_new_template_getsuggest_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_template_getsuggest_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_template_getsuggest_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_template_getsuggest_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_template_getsuggest_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_template_getsuggest_response.top_result.info.error_code |
| top_result.recommend_template_v_o_top_bulk_data | TopBulkData | 未标注 | 推荐模板对象 | — | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data |
| top_result.recommend_template_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.count |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list | RecommendTemplateVO [] | 未标注 | 推荐模板列表 | — | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].cate_id | Number | 未标注 | 业务对象标识 | 50022703 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].cate_id |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].cate_name | String | 未标注 | 业务字段 cate_name | 大家电 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].cate_name |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates | ComponentTemplateVO [] | 未标注 | 业务集合 | — | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].template_id | Number | 未标注 | 模板标识 | 4142621866453414266 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].template_id |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].template_name | String | 未标注 | 模板名称 | 拿量地域 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].template_name |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].template_desc | String | 未标注 | 业务字段 template_desc | 拿量地域xxx | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].template_desc |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].template_type | String | 未标注 | 模板类型 | AREA | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].template_type |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].template_value | String | 未标注 | 模板值 | [70,121,85,90,514] | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].template_value |
| top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list[].templates[].rec_type | String | 未标注 | 业务字段 rec_type | 效果优 | universalbp_new_template_getsuggest_response.top_result.recommend_template_v_o_top_bulk_data.recommend_template_v_o_list.recommend_template_v_o[].templates.component_template_v_o[].rec_type |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.template.getsuggest",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "tetris_template_query_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.template.getsuggest\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"tetris_template_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：55c55eaaa4ab47d468cf44d6d35679d4c03bad9d7f3257476b9f58f8af33af0c



---

# 实时报表查询（猫超专用）

`taobao.universalbp.new.report.query.realtime.maochao`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=73719)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_real_time_report_query_v_o | TopRealTimeReportQueryVO | 是 | 时间报表查询对象 | — |
| top_real_time_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_real_time_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_real_time_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_real_time_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| top_real_time_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-06 |
| top_real_time_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| top_real_time_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [campaign， date] |
| top_real_time_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_real_time_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_real_time_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合；全站推分时数据必传 | [68798644117] |
| top_real_time_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_real_time_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_real_time_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_real_time_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_real_time_report_query_v_o.source_list | String [] | 否 | 业务条件集合 | [SCENE] |

## 响应业务字段

TOP 响应外层：`universalbp_new_report_query_realtime_maochao_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_realtime_maochao_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_realtime_maochao_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_realtime_maochao_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_realtime_maochao_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_roi | String | 未标注 | 业务字段 retained_roi | 100 | universalbp_new_report_query_realtime_maochao_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_roi |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.realtime.maochao",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_real_time_report_query_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.report.query.realtime.maochao\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_real_time_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：6d95529e5ab58ca09eed047b5ffd94aba04ae3541d2c6e738defe45c5bd5e5a5



---

# 实时报表查询(直播专用)

`taobao.universalbp.new.report.query.realtime.live`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=74235)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_real_time_report_query_v_o | TopRealTimeReportQueryVO | 是 | 时间报表查询对象 | — |
| top_real_time_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_real_time_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_real_time_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_real_time_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| top_real_time_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-06 |
| top_real_time_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| top_real_time_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [campaign， date] |
| top_real_time_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_real_time_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_real_time_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合；全站推分时数据必传 | [68798644117] |
| top_real_time_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_real_time_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_real_time_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_real_time_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_real_time_report_query_v_o.source_list | String [] | 否 | 业务条件集合 | [SCENE] |

## 响应业务字段

TOP 响应外层：`universalbp_new_report_query_realtime_live_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_realtime_live_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_realtime_live_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_realtime_live_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_realtime_live_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_roi | String | 未标注 | 业务字段 retained_roi | 100 | universalbp_new_report_query_realtime_live_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_roi |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.realtime.live",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_real_time_report_query_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.report.query.realtime.live\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_real_time_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：e9b09fbf2764d0f254eb9a279278b49dba9f81e8c1aa23354cce9cfba1ea3bcd



---

# 实时报表查询(秒杀专用)

`taobao.universalbp.new.report.query.realtime.miaosha`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=74236)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| top_real_time_report_query_v_o | TopRealTimeReportQueryVO | 是 | 时间报表查询对象 | — |
| top_real_time_report_query_v_o.by_page | Boolean | 是 | 是否分页 | true |
| top_real_time_report_query_v_o.split_type | String | 是 | 统计拆分方式 | hour |
| top_real_time_report_query_v_o.unify_type | String | 是 | 转化归因口径 | zhai |
| top_real_time_report_query_v_o.start_time | String | 否 | 查询或投放起始时间 | 2023-06-06 |
| top_real_time_report_query_v_o.end_time | String | 否 | 查询或投放结束时间 | 2023-06-06 |
| top_real_time_report_query_v_o.effect_equal | Number | 否 | 转化统计窗口 | 15 |
| top_real_time_report_query_v_o.query_domains | String [] | 是 | 统计维度集合 | [campaign， date] |
| top_real_time_report_query_v_o.query_field_in_list | String [] | 是 | 返回指标集合；查询指标必填 | adPv |
| top_real_time_report_query_v_o.biz_code_in_list | String [] | 否 | 统计场景集合 | [onebpDisplay] |
| top_real_time_report_query_v_o.strategy_campaign_id_in_list | Number [] | 否 | 计划标识集合；全站推分时数据必传 | [68798644117] |
| top_real_time_report_query_v_o.offset | Number | 否 | 结果起始偏移 | 10 |
| top_real_time_report_query_v_o.page_size | Number | 否 | 单页条数 | 10 |
| top_real_time_report_query_v_o.source | String | 否 | 请求来源标识 | baseReport |
| top_real_time_report_query_v_o.original_biz_code_in_list | String [] | 否 | 编码集合 | [adStrategyDkx, adStrategyFans, adStrategyRuHui, adStrategyCrowd] |
| top_real_time_report_query_v_o.source_list | String [] | 否 | 业务条件集合 | [SCENE] |

## 响应业务字段

TOP 响应外层：`universalbp_new_report_query_realtime_miaosha_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_report_query_realtime_miaosha_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_report_query_realtime_miaosha_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_report_query_realtime_miaosha_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_report_query_realtime_miaosha_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.info.error_code |
| top_result.top_report_v_o_top_bulk_data | TopBulkData | 未标注 | 报表对象 | — | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data |
| top_result.top_report_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.count |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list | TopReportVO [] | 未标注 | 报表列表 | — | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].biz_code | String | 未标注 | 推广场景标识 | onebpDisplay | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].biz_code |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].hour_id | String | 未标注 | 数据所属小时 | 15 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].hour_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].scene1_name | String | 未标注 | 业务字段 scene1_name | 人群推广 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].scene1_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].thedate | String | 未标注 | 数据所属日期 | 2023-06-12 16:00 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].thedate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_id | String | 未标注 | 推广计划编号 | 11111111 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].campaign_name | String | 未标注 | 推广计划名称 | 促进成交_最大化拿量 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].campaign_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_id | String | 未标注 | 推广单元编号 | 11111111 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].adgroup_name | String | 未标注 | 推广单元名称 | 测试商品 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].adgroup_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].original_word | String | 未标注 | 业务字段 original_word | 瘦肩 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].original_word |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bidword_pkg_id | String | 未标注 | 关键词标识 | 1111111 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bidword_pkg_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bid_word_type | String | 未标注 | 出价词类型 | 词 word， 词包 wordPkg | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bid_word_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_id | String | 未标注 | 推广主体编号 | 670425387744 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].promotion_name | String | 未标注 | 业务字段 promotion_name | 测试商品 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].promotion_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].img_url | String | 未标注 | 业务字段 img_url | http://****.com | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].img_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].link_url | String | 未标注 | 业务字段 link_url | http://****.com | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].link_url |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].bp_crowd_id | String | 未标注 | 人群标识 | 676456456456 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].bp_crowd_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].crowd_name | String | 未标注 | 人群名称 | 店铺长期价值人群 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].crowd_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_id | String | 未标注 | 广告创意编号 | 710660000650001 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_name | String | 未标注 | 广告创意名称 | 方图1:1资源位_20230511_111045 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_image_path | String | 未标注 | 业务字段 creative_image_path | http://****.com | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_image_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_vedio_path | String | 未标注 | 业务字段 creative_vedio_path | http://****.com | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_vedio_path |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].creative_size | String | 未标注 | 业务字段 creative_size | 800*800 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].creative_size |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_id | String | 未标注 | 创意标识 | 702675398571 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].black_creative_promotion_type | String | 未标注 | 业务字段 black_creative_promotion_type | 11 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].black_creative_promotion_type |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_id | String | 未标注 | 业务对象标识 | 599 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].province_name | String | 未标注 | 业务字段 province_name | 中国香港 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].province_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_id | String | 未标注 | 城市标识 | 599 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_id |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].city_name | String | 未标注 | 城市名称 | 中国香港 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].city_name |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index | TopReportIndexVO | 未标注 | 统计指标内容 | — | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.total_charge | String | 未标注 | 业务字段 total_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.total_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.crowd_scene_charge | String | 未标注 | 业务字段 crowd_scene_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.crowd_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_scene_charge | String | 未标注 | 业务字段 item_scene_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.activity_scene_charge | String | 未标注 | 业务字段 activity_scene_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.activity_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.display_charge | String | 未标注 | 业务字段 display_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.display_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.search_charge | String | 未标注 | 业务字段 search_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.search_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.content_scene_charge | String | 未标注 | 业务字段 content_scene_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.content_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_scene_charge | String | 未标注 | 业务字段 shop_scene_charge | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_scene_charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ad_pv | String | 未标注 | 广告展现次数 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ad_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.click | String | 未标注 | 点击次数 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.click |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.charge | String | 未标注 | 推广花费 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.charge |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ctr | String | 未标注 | 点击比例 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ctr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpc | String | 未标注 | 业务字段 ecpc | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpc |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ecpm | String | 未标注 | 业务字段 ecpm | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ecpm |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_amt | String | 未标注 | 业务字段 prepay_inshop_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_inshop_num | String | 未标注 | 业务字段 prepay_inshop_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_amt | String | 未标注 | 业务字段 prepay_dir_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_dir_num | String | 未标注 | 业务字段 prepay_dir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_amt | String | 未标注 | 业务字段 prepay_indir_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.prepay_indir_num | String | 未标注 | 业务字段 prepay_indir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.prepay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_amt | String | 未标注 | 业务字段 alipay_dir_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_amt | String | 未标注 | 业务字段 alipay_indir_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt | String | 未标注 | 归因成交金额 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num | String | 未标注 | 归因成交数量 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_dir_num | String | 未标注 | 业务字段 alipay_dir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_indir_num | String | 未标注 | 业务字段 alipay_indir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cvr | String | 未标注 | 转化比例 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cvr |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.roi | String | 未标注 | 投入产出比 | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.roi |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_cost | String | 未标注 | 业务字段 alipay_inshop_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_inshop_num | String | 未标注 | 业务字段 cart_inshop_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_dir_num | String | 未标注 | 业务字段 cart_dir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_indir_num | String | 未标注 | 业务字段 cart_indir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_rate | String | 未标注 | 业务字段 cart_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_num | String | 未标注 | 业务字段 item_col_inshop_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_dir_num | String | 未标注 | 业务字段 shop_col_dir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shop_col_inshop_cost | String | 未标注 | 业务字段 shop_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shop_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_num | String | 未标注 | 业务字段 col_cart_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_cart_cost | String | 未标注 | 业务字段 col_cart_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart | String | 未标注 | 业务字段 item_col_cart | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_cart_cost | String | 未标注 | 业务字段 item_col_cart_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.col_num | String | 未标注 | 业务字段 col_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.col_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_cost | String | 未标注 | 业务字段 item_col_inshop_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_inshop_rate | String | 未标注 | 业务字段 item_col_inshop_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_inshop_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.cart_cost | String | 未标注 | 业务字段 cart_cost | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.cart_cost |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_num | String | 未标注 | 业务字段 gmv_inshop_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.gmv_inshop_amt | String | 未标注 | 业务字段 gmv_inshop_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.gmv_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_dir_num | String | 未标注 | 业务字段 item_col_dir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_dir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.item_col_indir_num | String | 未标注 | 业务字段 item_col_indir_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.item_col_indir_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.coupon_shop_num | String | 未标注 | 业务字段 coupon_shop_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.coupon_shop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_num | String | 未标注 | 业务字段 shopping_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.shopping_amt | String | 未标注 | 业务字段 shopping_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.shopping_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ww_num | String | 未标注 | 业务字段 ww_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ww_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv | String | 未标注 | 业务字段 inshop_pv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_uv | String | 未标注 | 业务字段 inshop_uv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv | String | 未标注 | 业务字段 inshop_potential_uv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_potential_uv_rate | String | 未标注 | 业务字段 inshop_potential_uv_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_potential_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_rate | String | 未标注 | 业务字段 rh_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.rh_num | String | 未标注 | 业务字段 rh_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.rh_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.inshop_pv_rate | String | 未标注 | 业务字段 inshop_pv_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.inshop_pv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.deep_inshop_pv | String | 未标注 | 业务字段 deep_inshop_pv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.deep_inshop_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.avg_access_page_num | String | 未标注 | 业务字段 avg_access_page_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.avg_access_page_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv | String | 未标注 | 业务字段 new_alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.new_alipay_inshop_uv_rate | String | 未标注 | 业务字段 new_alipay_inshop_uv_rate | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.new_alipay_inshop_uv_rate |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_sg_uv | String | 未标注 | 业务字段 hy_sg_uv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_sg_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_amt | String | 未标注 | 业务字段 hy_pay_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.hy_pay_num | String | 未标注 | 业务字段 hy_pay_num | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.hy_pay_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.natural_pay_amt | String | 未标注 | 业务字段 natural_pay_amt | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.natural_pay_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.org_natural_pv | String | 未标注 | 业务字段 org_natural_pv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.org_natural_pv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_uv | String | 未标注 | 业务字段 alipay_inshop_uv | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_uv |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_num_avg | String | 未标注 | 业务字段 alipay_inshop_num_avg | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_num_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.alipay_inshop_amt_avg | String | 未标注 | 业务字段 alipay_inshop_amt_avg | xxxxx | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.alipay_inshop_amt_avg |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_amt | String | 未标注 | 业务字段 ds_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_amt | String | 未标注 | 业务字段 sg_alipay_inshop_amt | 100 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_amt |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.ds_alipay_inshop_num | String | 未标注 | 业务字段 ds_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.ds_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.sg_alipay_inshop_num | String | 未标注 | 业务字段 sg_alipay_inshop_num | 100 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.sg_alipay_inshop_num |
| top_result.top_report_v_o_top_bulk_data.top_report_v_o_list[].report_index.retained_roi | String | 未标注 | 业务字段 retained_roi | 100 | universalbp_new_report_query_realtime_miaosha_response.top_result.top_report_v_o_top_bulk_data.top_report_v_o_list.top_report_v_o[].report_index.retained_roi |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.report.query.realtime.miaosha",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "top_real_time_report_query_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.report.query.realtime.miaosha\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"top_real_time_report_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：0e18ca295dbbd578ce62711f11f0b4c79c047be0862e7e3132925cad82bd06fb



---

# 批量更新计划三维出价

`taobao.universalbp.new.campaign.wholebid.batchupdate`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=75100)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 JSON 的 params 内。必填列保留官方标注；官方未标注的内容不推定为必填或可选。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| campaign_bid_command_list_v_o | CampaignBidCommandListVO | 是 | 计划出价操作列表 | — |
| campaign_bid_command_list_v_o.bid_list | CampaignBidCommandVO [] | 是 | 出价列表 | — |
| campaign_bid_command_list_v_o.bid_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_command_list_v_o.bid_list[].bid_type | String | 否 | 出价类型；枚举：custom_bid=手动出价、max_amount=最大化拿量、pe=控成本、roi_control=控投产比 | max_amount |
| campaign_bid_command_list_v_o.bid_list[].cold_boot | Number | 否 | 业务字段 cold_boot；枚举：0=否、1=是 | 1 |
| campaign_bid_command_list_v_o.bid_list[].optimize_target | String | 否 | 优化目标；枚举：conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
| campaign_bid_command_list_v_o.bid_list[].constraint_type | String | 否 | 业务字段 constraint_type；枚举：non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束 | 元/次点击 |
| campaign_bid_command_list_v_o.bid_list[].constraint_value | String | 否 | 业务字段 constraint_value | 3 |
| campaign_bid_command_list_v_o.bid_list[].campaign_ocpc | CampaignOcpcCommandVO | 否 | 计划对象 | — |
| campaign_bid_command_list_v_o.bid_list[].campaign_ocpc.enable_ocpc | Boolean | 否 | 业务字段 enable_ocpc；枚举：true=是、false=否 | true |
| campaign_bid_command_list_v_o.bid_list[].campaign_ocpc.ocpc_ratio | Number | 否 | 业务字段 ocpc_ratio | 200 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list | CrowdRefCommandVO [] | 否 | 人群列表 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list | ShowTagVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].code | String | 否 | 结果或业务代码 | hign_cvr |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].name | String | 否 | 对象名称 | 高转化率 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].tips | String | 否 | 业务字段 tips | xxxxxx |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].icon | String | 否 | 业务字段 icon | xxxxxx |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].color | String | 否 | 业务字段 color | #FF4D4D |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].type | String | 否 | 类型 | display_ocpc |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].show_tag_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_command_list_v_o.bid_list[].crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_command_list_v_o.bid_list[].adzone_list | AdzoneRefCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].adzone_list[].adzone_id | Number | 否 | 业务对象标识 | 111287850198 |
| campaign_bid_command_list_v_o.bid_list[].adzone_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| campaign_bid_command_list_v_o.bid_list[].adzone_list[].discount | Number | 否 | 出价溢价 | 3 |
| campaign_bid_command_list_v_o.bid_list[].adzone_list[].status | String | 否 | 状态标识；枚举：start=投放、pause=暂停 | start |
| campaign_bid_command_list_v_o.bid_list[].crowd_discount | Number | 否 | 业务字段 crowd_discount | 30 |
| campaign_bid_command_list_v_o.bid_list[].word_price | String | 否 | 词金额 | 30 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd | CrowdRefCommandVO | 否 | 人群对象 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd | CrowdCommandVO | 否 | 人群 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.target_type | Number | 否 | 目标类型 | 130 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list | ShowTagVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].code | String | 否 | 结果或业务代码 | hign_cvr |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].name | String | 否 | 对象名称 | 高转化率 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].tips | String | 否 | 业务字段 tips | xxxxxx |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].icon | String | 否 | 业务字段 icon | xxxxxx |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].color | String | 否 | 业务字段 color | #FF4D4D |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].type | String | 否 | 类型 | display_ocpc |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.show_tag_list[].properties | String | 否 | 扩展属性内容 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.price | PriceCommandVO | 否 | 金额 | — |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.price.bid_price | String | 否 | 出价金额 | 30 |
| campaign_bid_command_list_v_o.bid_list[].extend_crowd.price.discount | String | 否 | 出价溢价 | 30 |
| campaign_bid_command_list_v_o.bid_list[].bid_type_v2 | String | 否 | 业务字段 bid_type_v2 | smart_bid |
| campaign_bid_command_list_v_o.bid_list[].bid_target_v2 | String | 否 | 业务字段 bid_target_v2 | conv |
| campaign_bid_command_list_v_o.bid_list[].set_single_cost_v2 | Boolean | 否 | 业务字段 set_single_cost_v2 | true |
| campaign_bid_command_list_v_o.bid_list[].majorization_p_p_c | Boolean | 否 | 业务字段 majorization_p_p_c | false |
| campaign_bid_command_list_v_o.bid_list[].promotion_strategy | String | 否 | 业务字段 promotion_strategy | xxxxx |
| campaign_bid_command_list_v_o.bid_list[].user_type | Number | 否 | 业务字段 user_type | 10 |
| campaign_bid_command_list_v_o.bid_list[].premium_option | Number | 否 | 业务字段 premium_option | 10 |
| campaign_bid_command_list_v_o.bid_list[].bid_conv_type | String | 否 | 业务字段 bid_conv_type；枚举：retained_buy=净成交、dir_conv=总成交 | xxxxx |
| campaign_bid_command_list_v_o.bid_list[].launch_period_list | CampaignLaunchPeriodCommandVO [] | 否 | 列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].launch_period_list[].day_of_week | Number | 否 | 业务字段 day_of_week | 1 |
| campaign_bid_command_list_v_o.bid_list[].launch_period_list[].time_span_list | TimeSpanVO [] | 否 | 时间列表集合 | — |
| campaign_bid_command_list_v_o.bid_list[].launch_period_list[].time_span_list[].discount | Number | 否 | 出价溢价 | 100 |
| campaign_bid_command_list_v_o.bid_list[].launch_period_list[].time_span_list[].time | String | 否 | 时间 | 00:00-24:00 |

## 响应业务字段

TOP 响应外层：`universalbp_new_campaign_wholebid_batchupdate_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_campaign_wholebid_batchupdate_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_campaign_wholebid_batchupdate_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_campaign_wholebid_batchupdate_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_campaign_wholebid_batchupdate_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_campaign_wholebid_batchupdate_response.top_result.info.error_code |
| top_result.object_top_data | TopData | 未标注 | 业务对象 | — | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data |
| top_result.object_top_data.count | Number | 未标注 | 结果计数 | 1 | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.count |
| top_result.object_top_data.object_list | Number [] | 未标注 | 业务条件集合 | null,null | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.object_list |
| top_result.object_top_data.error_count | Number | 未标注 | 失败项数 | 1 | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.error_count |
| top_result.object_top_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.error_details |
| top_result.object_top_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.error_details.top_fail_result[].code |
| top_result.object_top_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.error_details.top_fail_result[].msg |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.wholebid.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_bid_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.campaign.wholebid.batchupdate\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"campaign_bid_command_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.object_top_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_campaign_wholebid_batchupdate_response.top_result.object_top_data.error_details）

来源校验 SHA256：4fc11f27f19a10ccb63d4303da574bab04a6775296ca3262ba5ad9a72099aa26



---

# 批量编辑人群

`taobao.universalbp.new.blackcrowd.batchmodify`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=75393)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

TOP 响应外层：`universalbp_new_blackcrowd_batchmodify_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_blackcrowd_batchmodify_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_blackcrowd_batchmodify_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_blackcrowd_batchmodify_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_blackcrowd_batchmodify_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_blackcrowd_batchmodify_response.top_result.info.error_code |
| top_result.crowd_ref_update_result_v_o_top_part_data | TopPartData | 未标注 | 人群结果对象 | — | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data |
| top_result.crowd_ref_update_result_v_o_top_part_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.count |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list | CrowdRefUpdateResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].campaign_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].adgroup_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].crowd_id |
| top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.crowd_ref_update_result_v_o_list.crowd_ref_update_result_v_o[].count |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_count | Number | 未标注 | 失败项数 | 10 | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_count |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details | TopFailResult [] | 未标注 | 逐项失败明细 | — | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details[].code | String | 未标注 | 结果或业务代码 | xxxxx | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details.top_fail_result[].code |
| top_result.crowd_ref_update_result_v_o_top_part_data.error_details[].msg | String | 未标注 | 结果提示 | xxxxx | universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details.top_fail_result[].msg |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.blackcrowd.batchmodify",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_ref_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.blackcrowd.batchmodify\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_ref_command_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

- top_result.crowd_ref_update_result_v_o_top_part_data.error_details：批量操作可逐项失败，应核对失败计数和明细。（样例路径：universalbp_new_blackcrowd_batchmodify_response.top_result.crowd_ref_update_result_v_o_top_part_data.error_details）

来源校验 SHA256：9b9c2dfca79fbaa5c28955d4814dc3c426a0a921b66cab7c136c721c171f9550



---

# 获取完整人群定向结构

`taobao.universalbp.new.crowd.generalcrowdconvert`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=75394)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_convert_query_list_v_o | CrowdConvertQueryListVO | 是 | 人群查询列表对象 | — |
| crowd_convert_query_list_v_o.label_list | CrowdConvertQueryVO [] | 是 | 定向标签列表 | — |
| crowd_convert_query_list_v_o.label_list[].label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_convert_query_list_v_o.label_list[].target_type | Number | 否 | 目标类型 | 131 |
| crowd_convert_query_list_v_o.label_list[].target_value | String | 否 | 目标值 | 11111 |
| crowd_convert_query_list_v_o.label_list[].option_list | OptionQueryVO [] | 否 | 列表集合 | — |
| crowd_convert_query_list_v_o.label_list[].option_list[].option_name | String | 否 | 业务字段 option_name | 自定义人群0608200328 |
| crowd_convert_query_list_v_o.label_list[].option_list[].option_value | String | 否 | 业务字段 option_value | 24431233 |
| crowd_convert_query_list_v_o.label_list[].option_list[].topic_id | Number | 否 | 业务对象标识 | 112 |
| crowd_convert_query_list_v_o.label_list[].option_list[].template_id | Number | 否 | 模板标识 | 77480 |
| crowd_convert_query_list_v_o.label_list[].option_list[].uuid_mark | String | 否 | 业务字段 uuid_mark | 99e5934edd6c4a54a52c1e7356ebecba |
| crowd_convert_query_list_v_o.label_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_convert_query_list_v_o.label_list[].cat_id | Number | 否 | 业务对象标识 | 50010850 |

## 响应业务字段

TOP 响应外层：`universalbp_new_crowd_generalcrowdconvert_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_crowd_generalcrowdconvert_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_crowd_generalcrowdconvert_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_crowd_generalcrowdconvert_response.top_result.info.error_code |
| top_result.crowd_ref_v_o_top_bulk_data | TopBulkData | 未标注 | 人群对象 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data |
| top_result.crowd_ref_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.count |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list | CrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].campaign_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].adgroup_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].online_status |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.average_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.min_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.max_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.validate_bid_min |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.validate_bid_max |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.price.peer_avg_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.average_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.min_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.max_fit_bid_price |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.validate_bid_min |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.validate_bid_max |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.fit_discount |
| top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_crowd_generalcrowdconvert_response.top_result.crowd_ref_v_o_top_bulk_data.crowd_ref_v_o_list.crowd_ref_v_o[].price.peer_avg_price |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.crowd.generalcrowdconvert",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_convert_query_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.crowd.generalcrowdconvert\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_convert_query_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：702086f9db29ab4ebe383a1ade1623e2869c8b27fb720d3151ef56a9902732b2



---

# 查询人群绑定列表

`taobao.universalbp.new.blackcrowd.findlist`

核对日期：2026-09-19；类型：查询操作。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=75395)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_bind_query_list_v_o | CrowdBindQueryListVO | 是 | 人群查询列表对象 | — |
| crowd_bind_query_list_v_o.crowd_bind_query_list | CrowdBindQueryVO [] | 是 | 人群查询列表集合 | — |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].offset | Number | 否 | 结果起始偏移 | 0 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].page_size | Number | 否 | 单页条数 | 20 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].campaign_id_list | Number [] | 否 | 计划标识列表 | [68792788657] |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68796878069 |
| crowd_bind_query_list_v_o.crowd_bind_query_list[].adgroup_id_list | Number [] | 否 | 单元标识列表；单元已经存在场景必填 | [68798447504] |

## 响应业务字段

TOP 响应外层：`universalbp_new_blackcrowd_findlist_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_blackcrowd_findlist_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_blackcrowd_findlist_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_blackcrowd_findlist_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_blackcrowd_findlist_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_blackcrowd_findlist_response.top_result.info.error_code |
| top_result.crowd_bind_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data |
| top_result.crowd_bind_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.count |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list | CrowdBindResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号；计划已经存在场景必填 | 68796878069 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].campaign_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68793666608 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].adgroup_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list | CrowdRefVO [] | 未标注 | 人群列表 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].campaign_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].adgroup_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].online_status |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.crowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.average_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.min_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.max_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_min |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.validate_bid_max |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.price.peer_avg_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.category_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.label.label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.lookalike_multiple |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price | PriceVO | 未标注 | 金额 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.average_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.min_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.max_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.validate_bid_min |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.validate_bid_max |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_list[].price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_list.crowd_ref_v_o[].price.peer_avg_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd | CrowdRefVO | 未标注 | 人群对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.campaign_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.adgroup_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.online_status | Number | 未标注 | 投放上下线状态；枚举：0、1=上线 | 1 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.online_status |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd | CrowdVO | 未标注 | 人群 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.crowd_id | Number | 未标注 | 人群标识 | 5526396502 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.crowd_name | String | 未标注 | 人群名称 | 目标人群扩展 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.crowd_value | String | 未标注 | 人群值 | 2191820003 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.crowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.target_type | Number | 未标注 | 目标类型 | 130 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label | LabelVO | 未标注 | 定向标签 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_desc | String | 未标注 | 业务字段 label_desc | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_value | String | 未标注 | 定向标签值 | 2000112 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_group_name | String | 未标注 | 业务字段 label_group_name | 人群 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price | PriceVO | 未标注 | 金额 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.average_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.min_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.max_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.validate_bid_min |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.validate_bid_max |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.price.peer_avg_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list | OptionGroupVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_group_list[].option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_group_list.option_group_v_o[].option_list.option_v_o[].sub_value_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list | OptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].option_desc | String | 未标注 | 业务字段 option_desc | 该定向人群将继承原始计划已触达的消费者特征，缩短算法搜寻合适人群的冷启动周期，建议您同时开启【智能拓展】功能，提升投放效果。 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].option_desc |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].option_group_name | String | 未标注 | 业务字段 option_group_name | 性别 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].option_group_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.option_list[].sub_value_list | String [] | 未标注 | 值集合 | [183] | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.option_list.option_v_o[].sub_value_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.category_id | Number | 未标注 | 业务对象标识 | 3221312321 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.category_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.category_name | String | 未标注 | 业务字段 category_name | 服装 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.category_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.properties | String | 未标注 | 扩展属性内容 | {} | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_option_properties | LabelOptionProperties | 未标注 | 定向标签对象 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_option_properties |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_option_properties.dmp_option_group_id | String | 未标注 | 业务对象标识 | 1001 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_option_properties.dmp_option_group_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_option_properties.cate_name | String | 未标注 | 业务字段 cate_name | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_option_properties.cate_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.label.label_option_properties.cate_id | String | 未标注 | 业务对象标识 | 714616513841 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.label.label_option_properties.cate_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.lookalike_multiple | String | 未标注 | 业务字段 lookalike_multiple | 1 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.lookalike_multiple |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list | ExtendSeedCrowdRefVO [] | 未标注 | 人群列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdVO | 未标注 | 人群 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 未标注 | 人群标识 | 5536708993 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 未标注 | 人群名称 | 喜欢店铺新品的访客 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.crowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelVO | 未标注 | 定向标签 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.target_type | Number | 未标注 | 目标类型 | 131 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.target_type |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 未标注 | 定向标签标识 | 3000494 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 未标注 | 定向标签名称 | 关键词 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.label_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.price_dimension | String | 未标注 | 业务字段 price_dimension；枚举：OPTION=标签出价、LABEL=选项出价 | OPTION | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.price_dimension |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.is_multi | Boolean | 未标注 | 业务字段 is_multi；枚举：true、false=否 | true | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.is_multi |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionVO [] | 未标注 | 列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 未标注 | 业务字段 option_name | 人群特征继承 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 未标注 | 业务字段 option_value | 2000123 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].option_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 未标注 | 业务对象标识 | 100000 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.extend_seed_crowd_list.extend_seed_crowd_ref_v_o[].crowd.label.option_list.extend_seed_option_v_o[].tag_id |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.sub_crowd_list | SubCrowdVO [] | 未标注 | 人群列表集合 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.sub_crowd_list |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.sub_crowd_list[].subcrowd_name | String | 未标注 | 业务字段 subcrowd_name | 目标人群扩展 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_name |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.crowd.sub_crowd_list[].subcrowd_value | String | 未标注 | 业务字段 subcrowd_value | 2191820003 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.crowd.sub_crowd_list.sub_crowd_v_o[].subcrowd_value |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price | PriceVO | 未标注 | 金额 | — | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.bid_price | String | 未标注 | 出价金额 | 1.16 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.fit_bid_price | String | 未标注 | 业务字段 fit_bid_price | 0.70 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.average_bid_price | String | 未标注 | 业务字段 average_bid_price | 0.47 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.average_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.min_fit_bid_price | String | 未标注 | 业务字段 min_fit_bid_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.min_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.max_fit_bid_price | String | 未标注 | 业务字段 max_fit_bid_price | 0.84 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.max_fit_bid_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.validate_bid_min | String | 未标注 | 业务字段 validate_bid_min | 0.05 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.validate_bid_min |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.validate_bid_max | String | 未标注 | 业务字段 validate_bid_max | 99.99 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.validate_bid_max |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.discount | String | 未标注 | 出价溢价 | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.fit_discount | String | 未标注 | 业务字段 fit_discount | 30 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.fit_discount |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].extend_crowd.price.peer_avg_price | String | 未标注 | 业务字段 peer_avg_price | 0.56 | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].extend_crowd.price.peer_avg_price |
| top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list[].crowd_extend_type | String | 未标注 | 业务字段 crowd_extend_type | auto | universalbp_new_blackcrowd_findlist_response.top_result.crowd_bind_result_v_o_top_bulk_data.crowd_bind_result_v_o_list.crowd_bind_result_v_o[].crowd_extend_type |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.blackcrowd.findlist",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_bind_query_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.blackcrowd.findlist\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_bind_query_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

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 表示业务未完成。

来源校验 SHA256：dd3bfd1dfe906ede8b097f13df62f9e3c320a68465dd2ece4d008bf4966bf090



---

# 批量删除绑定人群

`taobao.universalbp.new.blackcrowd.batchdelete`

核对日期：2026-09-19；类型：修改操作（会实际生效）。

官方来源：[淘宝开放平台](https://developer.alibaba.com/docs/api.htm?apiId=75606)。本站字段参考是核对日期的版本，不代表官方未来变更已自动同步。

整理状态：请求及响应字段已核对。

## 请求业务字段

路径均位于本站 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 | 否 | 扩展参数 | {} |
| crowd_ref_command_list_v_o | CrowdRefCommandListVO | 是 | 人群操作列表对象 | — |
| crowd_ref_command_list_v_o.crowd_list | CrowdRefCommandVO [] | 是 | 人群列表 | — |
| crowd_ref_command_list_v_o.crowd_list[].campaign_id | Number | 否 | 推广计划编号；计划已经存在场景必填 | 68799007001 |
| crowd_ref_command_list_v_o.crowd_list[].adgroup_id | Number | 否 | 推广单元编号；单元已经存在场景必填 | 68796878061 |
| crowd_ref_command_list_v_o.crowd_list[].crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].online_status | Number | 否 | 投放上下线状态；枚举：0、1=上线 | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd | CrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_id | Number | 否 | 人群标识；人群已经存在场景必填 | 5526396502 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 目标人群扩展 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.crowd_value | String | 否 | 人群值 | 2191820003 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.target_type | Number | 否 | 目标类型 | 130 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label | LabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_type | Number | 否 | 目标类型 | 131 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_desc | String | 否 | 业务字段 label_desc | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_value | String | 否 | 定向标签值 | 2000112 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list | OptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.option_list[].sub_value_list | String [] | 否 | 值集合 | [183] |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties | LabelOptionProperties | 否 | 定向标签对象 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.dmp_option_group_id | String | 否 | 业务对象标识 | 1001 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_name | String | 否 | 业务字段 cate_name | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.label_option_properties.cate_id | String | 否 | 业务对象标识 | 714616513841 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.target_value | Number | 否 | 目标值 | 11111 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.label.is_multi | Boolean | 否 | 业务字段 is_multi | true |
| crowd_ref_command_list_v_o.crowd_list[].crowd.lookalike_multiple | String | 否 | 业务字段 lookalike_multiple | 1 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list | ExtendSeedCrowdRefCommandVO [] | 否 | 人群列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd | ExtendSeedCrowdCommandVO | 否 | 人群 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_id | Number | 否 | 人群标识 | 5536708993 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_name | String | 否 | 人群名称 | 喜欢店铺新品的访客 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label | ExtendSeedLabelCommandVO | 否 | 定向标签 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_id | Number | 否 | 定向标签标识 | 3000494 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_name | String | 否 | 定向标签名称 | 关键词 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list | ExtendSeedOptionCommandVO [] | 否 | 列表集合 | — |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_name | String | 否 | 业务字段 option_name | 人群特征继承 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_value | String | 否 | 业务字段 option_value | 2000123 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_id | Number | 否 | 业务对象标识 | 100000 |
| crowd_ref_command_list_v_o.crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].properties | String | 否 | 扩展属性内容 | — |
| crowd_ref_command_list_v_o.crowd_list[].price | PriceCommandVO | 否 | 金额 | — |
| crowd_ref_command_list_v_o.crowd_list[].price.bid_price | String | 否 | 出价金额 | 30 |
| crowd_ref_command_list_v_o.crowd_list[].price.discount | String | 否 | 出价溢价 | 30 |

## 响应业务字段

TOP 响应外层：`universalbp_new_blackcrowd_batchdelete_response`。字段路径从该外层内部开始；数组项以 [] 表示。

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 | 样例 JSON 路径 |
|---|---|---|---|---|---|
| top_result | TopResult | 未标注 | 接口业务结果 | — | universalbp_new_blackcrowd_batchdelete_response.top_result |
| top_result.info | TopInfo | 未标注 | 执行状态信息 | — | universalbp_new_blackcrowd_batchdelete_response.top_result.info |
| top_result.info.ok | Boolean | 未标注 | 业务是否成功 | true | universalbp_new_blackcrowd_batchdelete_response.top_result.info.ok |
| top_result.info.message | String | 未标注 | 业务结果提示 | 参数错误 | universalbp_new_blackcrowd_batchdelete_response.top_result.info.message |
| top_result.info.error_code | String | 未标注 | 业务错误标识 | xxxxx | universalbp_new_blackcrowd_batchdelete_response.top_result.info.error_code |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data | TopBulkData | 未标注 | 人群结果对象 | — | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.count | Number | 未标注 | 结果计数 | 10 | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.count |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list | CrowdRefDeleteResultVO [] | 未标注 | 人群结果列表集合 | — | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].campaign_id | Number | 未标注 | 推广计划编号 | 68799007001 | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].campaign_id |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].adgroup_id | Number | 未标注 | 推广单元编号 | 68796878061 | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].adgroup_id |
| top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list[].count | Number | 未标注 | 结果计数 | 2 | universalbp_new_blackcrowd_batchdelete_response.top_result.crowd_ref_delete_result_v_o_top_bulk_data.crowd_ref_delete_result_v_o_list.crowd_ref_delete_result_v_o[].count |

## 本站请求结构

以下为空结构或示例占位，按字段表补全后使用，不是查询实测结果。

```json

{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.blackcrowd.batchdelete",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "crowd_ref_command_list_v_o": {}
  }
}

```

## Python 调用示例

```python

# Python 3.9+，无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名，再由本程序直接请求淘宝；业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result

api_key = getpass("请输入奇门云密钥：").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.blackcrowd.batchdelete\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"crowd_ref_command_list_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey：").strip()

# 此接口会修改业务数据，请核对店铺、目标对象及金额。
print("即将执行：", body["method"], "店铺：", body["shopKey"])
print(json.dumps(body["params"], ensure_ascii=False, indent=2))
if input("确认执行请键入 CONFIRM：").strip() != "CONFIRM":
    raise SystemExit("已取消，未发送请求")

try:
    result = client.call("wanxiang", body)
    print(client.display(result))
    check_result(result)
except CallError as exc:
    print(client.display(exc.payload))
    raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时，先查询实际状态。


```

## 错误处理

签名阶段错误读取奇门云 error.code、error.message 和 details；淘宝直接返回的业务失败读取 error_response、top_result.info、逐项错误和 request_id，不把失败当成空数据。

- error_response：TOP 网关错误；应读取错误码及细分错误码，不能按空结果处理。

- top_result.info：HTTP 成功仍须核对业务 ok；false 表示业务未完成。

来源校验 SHA256：a203ba1e1b06e828e0dba33c6e61998d976208a520483a0b141141f2cb6078dd

