← 万相台接口目录

接口参考 · 查询操作

查询单个计划详情

taobao.universalbp.new.campaign.get

核对日期:2026-09-19。字段名称、类型与业务层级按淘宝文档整理;请求地址、鉴权和店铺选择按下方本站说明接入。

文档按上述日期核对;最新变更及详细场景规则请查看淘宝官方说明。

通过奇门云调用

  • 签名地址:POST https://api.miandanni.com/api/wanxiang/sign;Content-Type: application/json。
  • 客户购买的奇门云密钥用于申请签名;实际调用淘宝开放平台万相台官方 API。方法、字段、类型、层级、金额单位和场景以官方文档为准。奇门云校验客户服务、店铺归属与授权后签名,客户服务器直接请求淘宝并接收业务数据。
  • 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在业务脚本同目录,使用 Client.call。奇门云密钥不是淘宝 AppSecret;不要求客户自行计算平台签名。
  • 签名申请头 Authorization: Bearer 你的奇门云密钥。JSON 为 {shopKey, method, params};shopKey 必须属于当前客户。客户 Bearer 密钥不能转发到淘宝。
  • 业务参数放入 params,保留淘宝字段名、类型、层级及枚举。对象直接使用 JSON 对象;下表业务根字段不放在请求最外层。
  • app_key、session、sign、timestamp、v、format 等公共字段由服务器生成。签发的本店铺 session 和签名只能用于客户服务器,不进入前端、日志或公共仓库;AppSecret 和 refresh_token 不提供给客户。
  • 本站支持店铺直接登录:top_service_context.login_type 为 1,ext 为 {} 或字符串 "{}";不允许 member_id、其他账户身份或代理登录。官方表内此类字段用于说明差异,不能照抄传入。
  • 业务根对象未填写的必填子项需按官方文档补全。ID 保持精度,金额单位、日期范围和枚举以具体方法官方说明为准。
  • 签发成功为 {ok:true,data:{version:1,ticketId,service,method,issuedAt,request}},不表示业务已执行;客户端按合同执行 data.request。TOP fields 原样作为字符串表单发送,不改值。
  • 淘宝业务响应直接返回客户程序,保留 error_response、top_result、逐项错误和 request_id;HTTP 200 仍检查 top_result.info.ok。签名阶段失败读取奇门云 error.code、message 和 details。
  • 每次签名校验密钥、服务有效期、店铺归属、淘宝应用订购及授权。业务能力仍取决于淘宝资格与推广场景。签发限流不等于平台实际调用次数。
  • 一次签名只生成一份请求,不自动翻页或重试。创建、调价、启停、删除会实际生效;超时或结果未知先查询实际状态。ticketId 不是平台幂等键。
  • 签名不是一次性凭据,平台接受的时间窗口内可能重放;解绑、停用或到期阻止新签发,不能即时撤回已签发请求。老客户原程序继续可用。
  • 每周一北京时间凌晨2:00检查官方更新,经核对验证后同步,不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈,不误判为平台权限不足。
{
  "shopKey": "填写你授权店铺的 shopKey",
  "method": "taobao.universalbp.new.campaign.get",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_query_v_o": {}
  }
}

这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。

请求业务参数

以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。

官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。

20 / 20 个字段
字段路径类型 / 必填字段含义示例值
top_service_contextTopServiceContext必填含下级字段推广业务上下文—
top_service_context.biz_codeString必填推广场景标识xxxxx
top_service_context.login_typeNumber可选账户登录方式枚举:1、2=代理直投(叉乘账号)1
top_service_context.member_idNumber可选广告账户标识代理直投(叉乘)时必填12345
top_service_context.extString可选扩展参数{}
campaign_query_v_oCampaignQueryVO必填含下级字段计划查询条件—
campaign_query_v_o.status_listString []可选筛选状态集合[ "start", "pause" ]
campaign_query_v_o.promotion_scene_listString []可选业务条件集合["promotion_scene_crowd"]
campaign_query_v_o.need_target_crowd_listString []可选目标人群集合["smartCrowd"]
campaign_query_v_o.origin_secondary_scene_listString []可选业务条件集合["promotion_scene_item"]
campaign_query_v_o.promotion_type_listString []可选类型集合[ "item", "shop" ]
campaign_query_v_o.bid_type_listString []可选出价类型列表["roi_control"]
campaign_query_v_o.optimize_target_listString []可选优化目标列表["click"]
campaign_query_v_o.campaign_name_likeString可选业务字段 campaign_name_like计划名称
campaign_query_v_o.campaign_idNumber可选推广计划编号68796878069
campaign_query_v_o.campaign_id_listNumber []可选计划标识列表[68796878069]
campaign_query_v_o.item_idNumber可选商品编号752793518760
campaign_query_v_o.adgroup_requiredBoolean可选业务字段 adgroup_requiredfalse
campaign_query_v_o.offsetNumber可选结果起始偏移10
campaign_query_v_o.page_sizeNumber可选单页条数10

返回业务字段

响应外层为 universalbp_new_campaign_get_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。

175 / 175 个字段
字段路径类型 / 必填字段含义示例值
top_result样例 JSON:universalbp_new_campaign_get_response.top_resultTopResult官方未标注必填含下级字段接口业务结果—
top_result.info样例 JSON:universalbp_new_campaign_get_response.top_result.infoTopInfo官方未标注必填含下级字段执行状态信息—
top_result.info.ok样例 JSON:universalbp_new_campaign_get_response.top_result.info.okBoolean官方未标注必填业务是否成功true
top_result.info.message样例 JSON:universalbp_new_campaign_get_response.top_result.info.messageString官方未标注必填业务结果提示参数错误
top_result.info.error_code样例 JSON:universalbp_new_campaign_get_response.top_result.info.error_codeString官方未标注必填业务错误标识xxxxx
top_result.top_campaign_v_o样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_oTopCampaignVO官方未标注必填含下级字段计划—
top_result.top_campaign_v_o.campaign样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaignCampaignVO官方未标注必填含下级字段计划—
top_result.top_campaign_v_o.campaign.campaign_biz_code样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_biz_codeString官方未标注必填业务字段 campaign_biz_codeonebpDisplay
top_result.top_campaign_v_o.campaign.campaign_group_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_group_idNumber官方未标注必填计划标识25696724
top_result.top_campaign_v_o.campaign.campaign_group_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_group_nameString官方未标注必填业务字段 campaign_group_name测试
top_result.top_campaign_v_o.campaign.campaign_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_idNumber官方未标注必填推广计划编号计划已经存在场景必填68796878069
top_result.top_campaign_v_o.campaign.campaign_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_nameString官方未标注必填推广计划名称管家计划_宝贝候选集
top_result.top_campaign_v_o.campaign.promotion_scene样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_sceneString官方未标注必填业务字段 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.top_campaign_v_o.campaign.market_scene样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.market_sceneString官方未标注必填业务字段 market_scenewxt_live_max_view :最大化拿量
top_result.top_campaign_v_o.campaign.promotion_goals样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_goalsString官方未标注必填业务字段 promotion_goals枚举:shop_item=全店宝贝推广、new_item_speed_car=新品飞车、shop_crowd=店铺人群运营、brand_crowd=品牌人群运营、traffic_shoujiao=淘系焦点图、traffic_nd=全屏微详情traffic_nd
top_result.top_campaign_v_o.campaign.promotion_model样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_modelString官方未标注必填业务字段 promotion_modeldaily:持续推广,order:套餐包
top_result.top_campaign_v_o.campaign.promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_typeString官方未标注必填业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义item
top_result.top_campaign_v_o.campaign.promotion_type_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.promotion_type_listString []官方未标注必填类型集合["item"]
top_result.top_campaign_v_o.campaign.spot_continue样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.spot_continueNumber官方未标注必填业务字段 spot_continue10
top_result.top_campaign_v_o.campaign.sub_promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.sub_promotion_typeString官方未标注必填业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义urlitem
top_result.top_campaign_v_o.campaign.sub_promotion_type_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.sub_promotion_type_listString []官方未标注必填类型集合["item"]
top_result.top_campaign_v_o.campaign.optimize_target样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.optimize_targetString官方未标注必填优化目标枚举: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.top_campaign_v_o.campaign.online_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.online_statusNumber官方未标注必填投放上下线状态枚举:-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付0
top_result.top_campaign_v_o.campaign.display_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.display_statusString官方未标注必填推广展示状态枚举:pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款pause
top_result.top_campaign_v_o.campaign.top_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.top_statusBoolean官方未标注必填是否置顶枚举:true=置顶、false=不置顶true
top_result.top_campaign_v_o.campaign.top_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.top_timeDate官方未标注必填时间2023-06-12 12:00:00
top_result.top_campaign_v_o.campaign.dmc_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.dmc_typeString官方未标注必填预算方式标识枚举:normal=日预算、total=总预算、cycle=活动周期预算、day_freeze=日预算冻结、unlimit=不限预算normal
top_result.top_campaign_v_o.campaign.day_budget样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.day_budgetString官方未标注必填日预算100
top_result.top_campaign_v_o.campaign.smooth_option样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.smooth_optionString官方未标注必填每日预算投放节奏枚举:quick=天内尽快、smooth=天内平滑smooth
top_result.top_campaign_v_o.campaign.total_budget样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.total_budgetString官方未标注必填累计预算100
top_result.top_campaign_v_o.campaign.budget_period样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.budget_periodNumber官方未标注必填业务字段 budget_period7
top_result.top_campaign_v_o.campaign.period_smooth样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.period_smoothString官方未标注必填业务字段 period_smooth枚举:quick=天内尽快、smooth=天内平滑smooth
top_result.top_campaign_v_o.campaign.bid_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_typeString官方未标注必填出价类型枚举:custom_bid=手动出价、max_amount=最大化拿量、cost_control=控成本、roi_control=控投产比max_amount
top_result.top_campaign_v_o.campaign.campaign_ocpc样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpcCampaignOcpcVO官方未标注必填含下级字段计划对象—
top_result.top_campaign_v_o.campaign.campaign_ocpc.enable_ocpc样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpc.enable_ocpcString官方未标注必填业务字段 enable_ocpc枚举:0=否、1=是1
top_result.top_campaign_v_o.campaign.campaign_ocpc.ocpc_ratio样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.campaign_ocpc.ocpc_ratioNumber官方未标注必填业务字段 ocpc_ratio200
top_result.top_campaign_v_o.campaign.max_price样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.max_priceString官方未标注必填最大金额0.4
top_result.top_campaign_v_o.campaign.min_price样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.min_priceString官方未标注必填最小金额0.25
top_result.top_campaign_v_o.campaign.bid_unit样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_unitString官方未标注必填业务字段 bid_unit元/次点击
top_result.top_campaign_v_o.campaign.constraint_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.constraint_typeString官方未标注必填业务字段 constraint_type枚举:non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束元/次点击
top_result.top_campaign_v_o.campaign.constraint_value样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.constraint_valueString官方未标注必填业务字段 constraint_value3
top_result.top_campaign_v_o.campaign.cold_boot样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_bootNumber官方未标注必填业务字段 cold_boot枚举:0=否、1=是1
top_result.top_campaign_v_o.campaign.cold_boot_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_boot_timeDate官方未标注必填业务字段 cold_boot_time2023-06-11 23:56:23
top_result.top_campaign_v_o.campaign.cold_boot_stage样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.cold_boot_stageString官方未标注必填业务字段 cold_boot_stage枚举:cold=冷启动期、mature=成熟期、acc_fail=冷启动失败、acc_success=冷启动成功、accelerate=加速中mature
top_result.top_campaign_v_o.campaign.speed_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.speed_typeString官方未标注必填业务字段 speed_typexxxxx
top_result.top_campaign_v_o.campaign.launch_period_discount样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_discountString官方未标注必填业务字段 launch_period_discount100%
top_result.top_campaign_v_o.campaign.launch_period_display_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_display_timeString官方未标注必填业务字段 launch_period_display_time15:00-15:30
top_result.top_campaign_v_o.campaign.launch_period_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_typeString官方未标注必填业务字段 launch_period_type枚举:allTimeDiscount=不限时段、exposureTime=固定时长、timeDiscount=固定时段xxxxx
top_result.top_campaign_v_o.campaign.launch_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_timeCampaignLaunchTimeVO官方未标注必填含下级字段时间对象—
top_result.top_campaign_v_o.campaign.launch_time.start_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.start_timeDate官方未标注必填查询或投放起始时间2023-06-09 00:00:00
top_result.top_campaign_v_o.campaign.launch_time.end_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.end_timeDate官方未标注必填查询或投放结束时间2199-02-01 00:00:00
top_result.top_campaign_v_o.campaign.launch_time.launch_forever样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.launch_foreverBoolean官方未标注必填业务字段 launch_forever枚举:true=是、false=否true
top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_start_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_start_timeDate官方未标注必填业务字段 renewal_first_order_start_time2023-06-09 00:00:00
top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_end_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_time.renewal_first_order_end_timeDate官方未标注必填业务字段 renewal_first_order_end_time2199-02-01 00:00:00
top_result.top_campaign_v_o.campaign.launch_area_str_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_area_str_listString []官方未标注必填地域集合["1","19"] 或者 ["all"]
top_result.top_campaign_v_o.campaign.launch_period_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_listLaunchPeriodVO []官方未标注必填含下级字段列表集合—
top_result.top_campaign_v_o.campaign.launch_period_list[].day_of_week样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].day_of_weekNumber官方未标注必填业务字段 day_of_week1
top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.launch_period_list.launch_period_v_o[].time_span_listTimeSpanQueryResVO []官方未标注必填含下级字段时间列表集合—
top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list[].time样例 JSON: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[].timeString官方未标注必填时间00:00-24:00
top_result.top_campaign_v_o.campaign.launch_period_list[].time_span_list[].discount样例 JSON: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[].discountNumber官方未标注必填出价溢价100
top_result.top_campaign_v_o.campaign.crowd_filter_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_listCampaignCrowdFilterVO []官方未标注必填含下级字段人群列表集合—
top_result.top_campaign_v_o.campaign.crowd_filter_list[].behavior样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_list.campaign_crowd_filter_v_o[].behaviorString官方未标注必填业务字段 behavior枚举:purchase=购买人群、cart=加购人群、collection=收藏人群、arrival=进店人群shop_crowd
top_result.top_campaign_v_o.campaign.crowd_filter_list[].window样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_filter_list.campaign_crowd_filter_v_o[].windowString官方未标注必填业务字段 window枚举:7=7天、15=15天、30=30天、90=90天、180=180天、365=365天7
top_result.top_campaign_v_o.campaign.brand_filter_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_listCampaignBrandFilterVO []官方未标注必填含下级字段列表集合—
top_result.top_campaign_v_o.campaign.brand_filter_list[].brand_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_list.campaign_brand_filter_v_o[].brand_idString官方未标注必填业务对象标识20067
top_result.top_campaign_v_o.campaign.brand_filter_list[].deeplink_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.brand_filter_list.campaign_brand_filter_v_o[].deeplink_listString []官方未标注必填业务条件集合枚举:Discover=Discover 发现、Engage=Engage 种草、Enthuse=Enthuse 互动、Perform=Perform 行动、Initial=Initial 首购、Numerous=Numerous 复购、Keen=Keen 至爱["Engage"]
top_result.top_campaign_v_o.campaign.deeplink_brand_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_listDeeplinkBrandVO []官方未标注必填含下级字段列表集合—
top_result.top_campaign_v_o.campaign.deeplink_brand_list[].deeplink_brand_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_idString官方未标注必填业务对象标识20067
top_result.top_campaign_v_o.campaign.deeplink_brand_list[].deeplink_brand_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.deeplink_brand_list.deeplink_brand_v_o[].deeplink_brand_nameString官方未标注必填业务字段 deeplink_brand_nameLancome/兰蔻
top_result.top_campaign_v_o.campaign.gender_age_filter_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_listCampaignGenderAgeFilterVO []官方未标注必填含下级字段列表集合—
top_result.top_campaign_v_o.campaign.gender_age_filter_list[].gender样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_list.campaign_gender_age_filter_v_o[].genderString官方未标注必填业务字段 gender枚举:man=男性人群、woman=女性人群man
top_result.top_campaign_v_o.campaign.gender_age_filter_list[].age_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.gender_age_filter_list.campaign_gender_age_filter_v_o[].age_listString []官方未标注必填业务条件集合枚举: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.top_campaign_v_o.campaign.mini_detail样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detailCampaignMiniDetailCommandVO官方未标注必填含下级字段业务对象—
top_result.top_campaign_v_o.campaign.mini_detail.mini_detail_theme样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.mini_detail_themeString官方未标注必填业务字段 mini_detail_theme枚举:1=默认主题、7=品牌定制主题、4=店铺主题、5=拉新主题、2=新品主题1
top_result.top_campaign_v_o.campaign.mini_detail.private_mini_item_id_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_item_id_listNumber []官方未标注必填商品标识集合[714707465203, 714901906337]
top_result.top_campaign_v_o.campaign.mini_detail.private_mini_top_item_id_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_top_item_id_listNumber []官方未标注必填商品标识集合[714707465203]
top_result.top_campaign_v_o.campaign.mini_detail.private_mini_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.mini_detail.private_mini_typeNumber官方未标注必填业务字段 private_mini_type枚举:0=黑名单、1=白名单1
top_result.top_campaign_v_o.campaign.item_selected_mode样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.item_selected_modeString官方未标注必填业务字段 item_selected_mode枚举:shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品shop
top_result.top_campaign_v_o.campaign.shop_item_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.shop_item_typeString官方未标注必填店铺商品类型枚举:effect=效果优选、growing=全店成长、activity=活动选品、industry=行业尖货、scope=定义选品effect
top_result.top_campaign_v_o.campaign.shield_items样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.shield_itemsNumber []官方未标注必填业务字段 shield_items[714707465203, 714901906337]
top_result.top_campaign_v_o.campaign.scope_items样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.scope_itemsNumber []官方未标注必填业务字段 scope_items[714707465203, 714901906337]
top_result.top_campaign_v_o.campaign.adgroup_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_listAdgroupVO []官方未标注必填含下级字段单元列表—
top_result.top_campaign_v_o.campaign.adgroup_list[].gmt_create样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].gmt_createDate官方未标注必填业务字段 gmt_create2023-12-09 14:34:12
top_result.top_campaign_v_o.campaign.adgroup_list[].gmt_modified样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].gmt_modifiedDate官方未标注必填业务字段 gmt_modified2023-12-09 14:34:12
top_result.top_campaign_v_o.campaign.adgroup_list[].campaign_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].campaign_idNumber官方未标注必填推广计划编号计划已经存在场景必填68796878069
top_result.top_campaign_v_o.campaign.adgroup_list[].campaign_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].campaign_nameString官方未标注必填推广计划名称管家计划_宝贝候选集
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_idNumber官方未标注必填推广单元编号68793666608
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_nameString官方未标注必填推广单元名称ds460418344
top_result.top_campaign_v_o.campaign.adgroup_list[].online_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].online_statusNumber官方未标注必填投放上下线状态枚举:-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付0
top_result.top_campaign_v_o.campaign.adgroup_list[].display_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].display_statusString官方未标注必填推广展示状态枚举:pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款pause
top_result.top_campaign_v_o.campaign.adgroup_list[].audit_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].audit_statusNumber官方未标注必填业务字段 audit_status枚举:-1=待审核、0=后台下线状态、1=后台上线状态1
top_result.top_campaign_v_o.campaign.adgroup_list[].audit_reason样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].audit_reasonString官方未标注必填业务字段 audit_reasonxxxxx
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpcAdgroupOcpcVO官方未标注必填含下级字段单元对象—
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.enable_ocpc样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.enable_ocpcBoolean官方未标注必填业务字段 enable_ocpc枚举:false=否、true=是true
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_ratio样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_ratioNumber官方未标注必填业务字段 ocpc_ratio200
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_marketing_aim样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_marketing_aimString官方未标注必填业务字段 ocpc_marketing_aimclick
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ocpc_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ocpc_statusString官方未标注必填业务字段 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.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.enable_cold_speed_new_item样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.enable_cold_speed_new_itemBoolean官方未标注必填业务字段 enable_cold_speed_new_item枚举:true=是、false=否false
top_result.top_campaign_v_o.campaign.adgroup_list[].adgroup_ocpc.ecpc_option样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].adgroup_ocpc.ecpc_optionNumber官方未标注必填业务字段 ecpc_option1
top_result.top_campaign_v_o.campaign.adgroup_list[].promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].promotion_typeString官方未标注必填业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义item
top_result.top_campaign_v_o.campaign.adgroup_list[].sub_promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].sub_promotion_typeString官方未标注必填业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义urlitem
top_result.top_campaign_v_o.campaign.adgroup_list[].material样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].materialCommonMaterialVO官方未标注必填含下级字段素材—
top_result.top_campaign_v_o.campaign.adgroup_list[].material.material_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_idNumber官方未标注必填素材标识714616513841
top_result.top_campaign_v_o.campaign.adgroup_list[].material.material_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_typeNumber官方未标注必填素材类型枚举: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.top_campaign_v_o.campaign.adgroup_list[].material.material_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.material_nameString官方未标注必填素材名称yiliantest测试请不要拍22
top_result.top_campaign_v_o.campaign.adgroup_list[].material.title样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.titleString官方未标注必填展示标题yiliantest测试请不要拍22
top_result.top_campaign_v_o.campaign.adgroup_list[].material.img_url样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.img_urlString官方未标注必填业务字段 img_url//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
top_result.top_campaign_v_o.campaign.adgroup_list[].material.link_url样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.link_urlString官方未标注必填业务字段 link_urlhttp://item.taobao.com/item.htm?id=715121254343
top_result.top_campaign_v_o.campaign.adgroup_list[].material.price样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.priceString官方未标注必填金额999900
top_result.top_campaign_v_o.campaign.adgroup_list[].material.bid_count样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.bid_countNumber官方未标注必填出价数量899900
top_result.top_campaign_v_o.campaign.adgroup_list[].material.quantity样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.quantityNumber官方未标注必填业务字段 quantity10
top_result.top_campaign_v_o.campaign.adgroup_list[].material.first_starts_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.first_starts_timeDate官方未标注必填业务字段 first_starts_time2023-04-26 14:51:03
top_result.top_campaign_v_o.campaign.adgroup_list[].material.starts样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.startsDate官方未标注必填业务字段 starts2023-04-26 14:51:03
top_result.top_campaign_v_o.campaign.adgroup_list[].material.category_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.category_idString官方未标注必填业务对象标识16 50010850
top_result.top_campaign_v_o.campaign.adgroup_list[].material.promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.promotion_typeString官方未标注必填业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义item
top_result.top_campaign_v_o.campaign.adgroup_list[].material.sub_promotion_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.sub_promotion_typeString官方未标注必填业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义urlitem
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_listItemLifeCycleViewVO []官方未标注必填含下级字段列表集合列表中最多有2个元素—
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].life_cycle_desc样例 JSON: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_descString官方未标注必填业务字段 life_cycle_desc新品打爆期
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].color样例 JSON: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[].colorString官方未标注必填业务字段 color#36A2FC
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].tips样例 JSON: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[].tipsString官方未标注必填业务字段 tips近30日GMV排名在叶子类目5%以内的新品
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_list[].type样例 JSON: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[].typeNumber官方未标注必填类型1
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_days样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_daysNumber官方未标注必填业务字段 life_cycle_days3
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_diff_with_avg样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_diff_with_avgString官方未标注必填业务字段 life_cycle_diff_with_avg较慢
top_result.top_campaign_v_o.campaign.adgroup_list[].material.life_cycle_diff_with_avg_tips样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.life_cycle_diff_with_avg_tipsString官方未标注必填业务字段 life_cycle_diff_with_avg_tips快于同类目商品经历过同样阶段变化所用时间
top_result.top_campaign_v_o.campaign.adgroup_list[].material.grow_desc样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.grow_descString官方未标注必填业务字段 grow_desc日均再成交122.55元 可提高爆品类目排名卡位
top_result.top_campaign_v_o.campaign.adgroup_list[].material.grow_rank样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].material.grow_rankNumber官方未标注必填业务字段 grow_rank1077
top_result.top_campaign_v_o.campaign.adgroup_list[].alive_group_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].alive_group_idNumber官方未标注必填业务对象标识枚举:0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜0
top_result.top_campaign_v_o.campaign.adgroup_list[].alive_group_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].alive_group_nameString官方未标注必填业务字段 alive_group_name宝贝链接(默认)
top_result.top_campaign_v_o.campaign.adgroup_list[].black_creative_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].black_creative_statusString官方未标注必填业务字段 black_creative_status枚举:success=合成成功、fail=合成失败success
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_listSpotVO []官方未标注必填含下级字段列表集合—
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].spot_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].spot_idNumber官方未标注必填业务对象标识1
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_name样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_nameString官方未标注必填素材名称物料名称
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].title样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].titleString官方未标注必填展示标题物料标题
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].link_url样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].link_urlString官方未标注必填业务字段 link_urlhttps://h5.m.taobao.com/****timemove
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].img_url样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].img_urlString官方未标注必填业务字段 img_urlhttps://img.alicdn.com/******.jpg
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_idNumber官方未标注必填业务对象标识474297730705
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_title样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_titleString官方未标注必填业务字段 live_title直播间隔一小时抽免单
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_idNumber官方未标注必填素材标识474847464897
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].statusNumber官方未标注必填状态标识4
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_typeNumber官方未标注必填素材类型3
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].audit_reason样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].audit_reasonString官方未标注必填业务字段 audit_reason1
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].material_tag_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].material_tag_idNumber官方未标注必填素材标识40
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].quantity样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].quantityNumber官方未标注必填业务字段 quantity20
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].bid_count样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].bid_countNumber官方未标注必填出价数量20
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].item_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].item_idNumber官方未标注必填商品编号474847464777
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].outer_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].outer_statusNumber官方未标注必填业务字段 outer_status10
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_cover_img样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_cover_imgString官方未标注必填业务字段 live_cover_imghttps://gw.alicdn.com/****.jpg
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].audit_status样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].audit_statusNumber官方未标注必填业务字段 audit_status1
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_start_time样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].live_start_timeDate官方未标注必填业务字段 live_start_time2024-08-02 07:44:22
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].video_ori_url样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].video_ori_urlString官方未标注必填业务字段 video_ori_urlhttps://livecaing.alicdn.com/*****
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].pv样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].pvNumber官方未标注必填业务字段 pv35
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].trade_amt样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.adgroup_list.adgroup_v_o[].spot_list.spot_v_o[].trade_amtNumber官方未标注必填业务字段 trade_amt147
top_result.top_campaign_v_o.campaign.adgroup_list[].spot_list[].live_start_time_str样例 JSON: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_strString官方未标注必填业务字段 live_start_time_str2024-08-02 07:44:22
top_result.top_campaign_v_o.campaign.need_target_crowd样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.need_target_crowdNumber官方未标注必填业务字段 need_target_crowd1
top_result.top_campaign_v_o.campaign.more_campaign_switch样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.more_campaign_switchBoolean官方未标注必填业务字段 more_campaign_switchfalse
top_result.top_campaign_v_o.campaign.crowd_custom_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_custom_typeBoolean官方未标注必填业务字段 crowd_custom_typefalse
top_result.top_campaign_v_o.campaign.crowd_extend_type样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.crowd_extend_typeString官方未标注必填业务字段 crowd_extend_typeauto
top_result.top_campaign_v_o.campaign.origin_secondary_scene样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.origin_secondary_sceneString官方未标注必填业务字段 origin_secondary_scenepromotion_scene_item
top_result.top_campaign_v_o.campaign.scene_id样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.scene_idNumber官方未标注必填业务对象标识371
top_result.top_campaign_v_o.campaign.is_xinxiang样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.is_xinxiangBoolean官方未标注必填业务字段 is_xinxiangtrue
top_result.top_campaign_v_o.campaign.is_guarantee样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.is_guaranteeBoolean官方未标注必填业务字段 is_guaranteetrue
top_result.top_campaign_v_o.campaign.bid_type_v2样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_type_v2String官方未标注必填业务字段 bid_type_v2smart_bid
top_result.top_campaign_v_o.campaign.bid_target_v2样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.bid_target_v2String官方未标注必填业务字段 bid_target_v2conv
top_result.top_campaign_v_o.campaign.set_single_cost_v2样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.set_single_cost_v2Boolean官方未标注必填业务字段 set_single_cost_v2true
top_result.top_campaign_v_o.campaign.quick_lift_budget_command样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_commandCampaignQuickLiftCommandVO官方未标注必填含下级字段预算操作对象—
top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_switch样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_switchBoolean官方未标注必填业务字段 quick_lift_switch枚举:true=打开、false=关闭true
top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_budget样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_budgetString官方未标注必填业务字段 quick_lift_budget50
top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_time_slot样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_time_slotString官方未标注必填业务字段 quick_lift_time_slot0,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.top_campaign_v_o.campaign.quick_lift_budget_command.quick_lift_launch_area_listString []官方未标注必填地域集合—
top_result.top_campaign_v_o.campaign.quick_lift_switch样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.quick_lift_switchBoolean官方未标注必填业务字段 quick_lift_switch枚举:true=打开、false=关闭true
top_result.top_campaign_v_o.campaign.multi_target样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_targetCampaignMultiTargetVO官方未标注必填含下级字段目标对象—
top_result.top_campaign_v_o.campaign.multi_target.multi_target_switch样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_switchNumber官方未标注必填业务字段 multi_target_switch枚举:0=关闭、1=开启1
top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list样例 JSON:universalbp_new_campaign_get_response.top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_listCampaignMultiTargetConfigVO []官方未标注必填含下级字段目标列表集合—
top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list[].optimize_target样例 JSON: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_targetString官方未标注必填优化目标1034
top_result.top_campaign_v_o.campaign.multi_target.multi_target_config_list[].multi_target_budget样例 JSON: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_budgetString官方未标注必填业务字段 multi_target_budget1000

字段核对说明

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

Python 签名直连示例

下载 qimenyun_direct.py 与业务脚本放在同一目录,保留淘宝业务参数,使用奇门云密钥和 shopKey 申请签名,由客户服务器直接请求淘宝。运行前补全业务参数,无需自行计算平台签名。

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

api_key = getpass("请输入奇门云密钥:").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.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
# 不自动重试。写操作超时或结果未知时,先查询实际状态。

判断成功与失败

签名阶段先检查 HTTP 状态;本站鉴权、套餐或授权失败返回 {ok:false,error:{code,message}}。签名 HTTP 200 仅说明已签发;客户端执行官方请求后,还要检查淘宝响应的 error_response、逐项错误和 top_result.info.ok;失败不能当成空列表。

执行阶段的淘宝原始 error_response、业务 info 和 request_id 直接返回客户服务器,不由奇门云统一包装。签名和授权由本站管理,业务参数、日期、分页及平台资格按淘宝原始错误排查。

  • error_response:TOP 网关错误;应读取错误码及细分错误码,不能按空结果处理。
  • top_result.info:HTTP 成功仍须核对业务 ok;false 表示业务未完成。

下载本页 MD 可交给开发人员或 AI,密钥只填在自己的私密配置中。