← 万相台接口目录

接口参考 · 修改操作

批量更新计划出价

taobao.universalbp.new.campaign.onebpsearch.batchupdate

核对日期: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.onebpsearch.batchupdate",
  "params": {
    "top_service_context": {
      "biz_code": "universalBP",
      "login_type": 1,
      "ext": "{}"
    },
    "campaign_bid_list_v_o": {}
  }
}

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

请求业务参数

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

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

71 / 71 个字段
字段路径类型 / 必填字段含义示例值
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_bid_list_v_oCampaignBidListVO必填含下级字段计划出价列表—
campaign_bid_list_v_o.bid_listCampaignBidCommandVO []必填含下级字段出价列表—
campaign_bid_list_v_o.bid_list[].campaign_idNumber可选推广计划编号计划已经存在场景必填68796878069
campaign_bid_list_v_o.bid_list[].bid_typeString可选出价类型枚举:custom_bid=手动出价、max_amount=最大化拿量、pe=控成本、roi_control=控投产比max_amount
campaign_bid_list_v_o.bid_list[].cold_bootNumber可选业务字段 cold_boot枚举:0=否、1=是1
campaign_bid_list_v_o.bid_list[].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
campaign_bid_list_v_o.bid_list[].constraint_typeString可选业务字段 constraint_type枚举:non=无约束、click=点击成本、coll_cart=收藏加购成本(非场景推广)、cart=收藏加购成本(场景推广)、conv=成交成本(非场景推广)、deal=成交成本(场景推广)、dir_conv=直接成交成本、roi=投产比约束元/次点击
campaign_bid_list_v_o.bid_list[].constraint_valueString可选业务字段 constraint_value3
campaign_bid_list_v_o.bid_list[].campaign_ocpcCampaignOcpcCommandVO可选含下级字段计划对象—
campaign_bid_list_v_o.bid_list[].campaign_ocpc.enable_ocpcBoolean可选业务字段 enable_ocpc枚举:true=是、false=否true
campaign_bid_list_v_o.bid_list[].campaign_ocpc.ocpc_ratioNumber可选业务字段 ocpc_ratio200
campaign_bid_list_v_o.bid_list[].crowd_listCrowdRefCommandVO []可选含下级字段人群列表—
campaign_bid_list_v_o.bid_list[].crowd_list[].campaign_idNumber可选推广计划编号计划已经存在场景必填68799007001
campaign_bid_list_v_o.bid_list[].crowd_list[].adgroup_idNumber可选推广单元编号单元已经存在场景必填68796878061
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd_idNumber可选人群标识人群已经存在场景必填5526396502
campaign_bid_list_v_o.bid_list[].crowd_list[].online_statusNumber可选投放上下线状态枚举:0、1=上线1
campaign_bid_list_v_o.bid_list[].crowd_list[].crowdCrowdCommandVO可选含下级字段人群—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_idNumber可选人群标识人群已经存在场景必填5526396502
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_nameString可选人群名称目标人群扩展
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.crowd_valueString可选人群值2191820003
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.target_typeNumber可选目标类型130
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.labelLabelCommandVO可选含下级字段定向标签—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_typeNumber可选目标类型131
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_idNumber可选定向标签标识3000494
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_nameString可选定向标签名称关键词
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_descString可选业务字段 label_desc关键词
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_valueString可选定向标签值2000112
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_listOptionCommandVO []可选含下级字段列表集合—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_nameString可选业务字段 option_name人群特征继承
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].option_valueString可选业务字段 option_value2000123
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].tag_idNumber可选业务对象标识100000
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_propertiesLabelOptionProperties可选含下级字段定向标签对象—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.dmp_option_group_idString可选业务对象标识1001
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_nameString可选业务字段 cate_name714616513841
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].label_option_properties.cate_idString可选业务对象标识714616513841
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.option_list[].sub_value_listString []可选值集合[183]
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_propertiesLabelOptionProperties可选含下级字段定向标签对象—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.dmp_option_group_idString可选业务对象标识1001
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_nameString可选业务字段 cate_name714616513841
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.label_option_properties.cate_idString可选业务对象标识714616513841
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.label.target_valueNumber可选目标值11111
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.lookalike_multipleString可选业务字段 lookalike_multiple1
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_listExtendSeedCrowdRefCommandVO []可选含下级字段人群列表集合—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowdExtendSeedCrowdCommandVO可选含下级字段人群—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_idNumber可选人群标识5536708993
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.crowd_nameString可选人群名称喜欢店铺新品的访客
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.labelExtendSeedLabelCommandVO可选含下级字段定向标签—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_idNumber可选定向标签标识3000494
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.label_nameString可选定向标签名称关键词
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_listExtendSeedOptionCommandVO []可选含下级字段列表集合—
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_nameString可选业务字段 option_name人群特征继承
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].option_valueString可选业务字段 option_value2000123
campaign_bid_list_v_o.bid_list[].crowd_list[].crowd.extend_seed_crowd_list[].crowd.label.option_list[].tag_idNumber可选业务对象标识100000
campaign_bid_list_v_o.bid_list[].crowd_list[].pricePriceCommandVO可选含下级字段金额—
campaign_bid_list_v_o.bid_list[].crowd_list[].price.bid_priceString可选出价金额30
campaign_bid_list_v_o.bid_list[].crowd_list[].price.discountString可选出价溢价30
campaign_bid_list_v_o.bid_list[].adzone_listAdzoneRefCommandVO []可选含下级字段列表集合—
campaign_bid_list_v_o.bid_list[].adzone_list[].adzone_idNumber可选业务对象标识111287850198
campaign_bid_list_v_o.bid_list[].adzone_list[].campaign_idNumber可选推广计划编号计划已经存在场景必填68796878069
campaign_bid_list_v_o.bid_list[].adzone_list[].discountNumber可选出价溢价3
campaign_bid_list_v_o.bid_list[].adzone_list[].statusString可选状态标识枚举:start=投放、pause=暂停start
campaign_bid_list_v_o.bid_list[].crowd_discountNumber可选业务字段 crowd_discount30
campaign_bid_list_v_o.bid_list[].word_priceString可选词金额30
campaign_bid_list_v_o.bid_list[].bid_type_v2String可选业务字段 bid_type_v2smart_bid
campaign_bid_list_v_o.bid_list[].bid_target_v2String可选业务字段 bid_target_v2conv
campaign_bid_list_v_o.bid_list[].set_single_cost_v2Boolean可选业务字段 set_single_cost_v2true

返回业务字段

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

15 / 15 个字段
字段路径类型 / 必填字段含义示例值
top_result样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_resultTopResult官方未标注必填含下级字段接口业务结果—
top_result.info样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.infoTopInfo官方未标注必填含下级字段执行状态信息—
top_result.info.ok样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.okBoolean官方未标注必填业务是否成功true
top_result.info.message样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.messageString官方未标注必填业务结果提示参数错误
top_result.info.error_code样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.info.error_codeString官方未标注必填业务错误标识xxxxx
top_result.campaign_bid_update_result_v_o_top_part_data样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_dataTopPartData官方未标注必填含下级字段计划出价结果对象—
top_result.campaign_bid_update_result_v_o_top_part_data.count样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.countNumber官方未标注必填结果计数10
top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_listCampaignBidUpdateResultVO []官方未标注必填含下级字段计划出价结果列表集合—
top_result.campaign_bid_update_result_v_o_top_part_data.campaign_bid_update_result_v_o_list[].campaign_id样例 JSON: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_idNumber官方未标注必填推广计划编号计划已经存在场景必填68796878069
top_result.campaign_bid_update_result_v_o_top_part_data.error_count样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_countNumber官方未标注必填失败项数10
top_result.campaign_bid_update_result_v_o_top_part_data.error_details样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_detailsTopFailResult []官方未标注必填含下级字段逐项失败明细—
top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].code样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].codeString官方未标注必填结果或业务代码xxxxx
top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].msg样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].msgString官方未标注必填结果提示xxxxx
top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].resultCampaignBidUpdateResultVO官方未标注必填含下级字段执行结果内容—
top_result.campaign_bid_update_result_v_o_top_part_data.error_details[].result.campaign_id样例 JSON:universalbp_new_campaign_onebpsearch_batchupdate_response.top_result.campaign_bid_update_result_v_o_top_part_data.error_details.top_fail_result[].result.campaign_idNumber官方未标注必填推广计划编号68796878069

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.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
# 不自动重试。写操作超时或结果未知时,先查询实际状态。

判断成功与失败

签名阶段先检查 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 表示业务未完成。
  • top_result.campaign_bid_update_result_v_o_top_part_data.error_details:批量操作可逐项失败,应核对失败计数和明细。

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