# 查询单元分页列表

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

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

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

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

## 本站调用约定

- 签名地址：POST https://api.miandanni.com/api/wanxiang/sign；Content-Type: application/json。

- 客户购买的奇门云密钥用于申请签名；实际调用淘宝开放平台万相台官方 API。方法、字段、类型、层级、金额单位和场景以官方文档为准。奇门云校验客户服务、店铺归属与授权后签名，客户服务器直接请求淘宝并接收业务数据。

- 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在业务脚本同目录，使用 Client.call。奇门云密钥不是淘宝 AppSecret；不要求客户自行计算平台签名。

- 签名申请头 Authorization: Bearer 你的奇门云密钥。JSON 为 {shopKey, method, params}；shopKey 必须属于当前客户。客户 Bearer 密钥不能转发到淘宝。

- 业务参数放入 params，保留淘宝字段名、类型、层级及枚举。对象直接使用 JSON 对象；下表业务根字段不放在请求最外层。

- app_key、session、sign、timestamp、v、format 等公共字段由服务器生成。签发的本店铺 session 和签名只能用于客户服务器，不进入前端、日志或公共仓库；AppSecret 和 refresh_token 不提供给客户。

- 本站支持店铺直接登录：top_service_context.login_type 为 1，ext 为 {} 或字符串 "{}"；不允许 member_id、其他账户身份或代理登录。官方表内此类字段用于说明差异，不能照抄传入。

- 业务根对象未填写的必填子项需按官方文档补全。ID 保持精度，金额单位、日期范围和枚举以具体方法官方说明为准。

- 签发成功为 {ok:true,data:{version:1,ticketId,service,method,issuedAt,request}}，不表示业务已执行；客户端按合同执行 data.request。TOP fields 原样作为字符串表单发送，不改值。

- 淘宝业务响应直接返回客户程序，保留 error_response、top_result、逐项错误和 request_id；HTTP 200 仍检查 top_result.info.ok。签名阶段失败读取奇门云 error.code、message 和 details。

- 每次签名校验密钥、服务有效期、店铺归属、淘宝应用订购及授权。业务能力仍取决于淘宝资格与推广场景。签发限流不等于平台实际调用次数。

- 一次签名只生成一份请求，不自动翻页或重试。创建、调价、启停、删除会实际生效；超时或结果未知先查询实际状态。ticketId 不是平台幂等键。

- 签名不是一次性凭据，平台接受的时间窗口内可能重放；解绑、停用或到期阻止新签发，不能即时撤回已签发请求。老客户原程序继续可用。

- 每周一北京时间凌晨2:00检查官方更新，经核对验证后同步，不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈，不误判为平台权限不足。

## 请求业务字段

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

| 字段路径 | 类型 | 必填 | 字段含义 | 示例值 |
|---|---|---|---|---|
| top_service_context | TopServiceContext | 是 | 推广业务上下文 | — |
| top_service_context.biz_code | String | 是 | 推广场景标识 | xxxxx |
| top_service_context.login_type | Number | 否 | 账户登录方式；枚举：1、2=代理直投(叉乘账号) | 1 |
| top_service_context.member_id | Number | 否 | 广告账户标识；代理直投（叉乘）时必填 | 12345 |
| top_service_context.ext | String | 否 | 扩展参数 | {} |
| adgroup_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

