文档中心 > API类目 > 万相台无界API

taobao.universalbp.new.adgroup.updatepart (修改单元或主体状态)

修改单元或主体的状态(暂只用于关键词、人群)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
adgroup_update_part_list_v_o AdgroupUpdatePartListVO 必须 adgroupUpdatePartListVO
  • adgroup_list
  • AdgroupUpdatePartCommandVO []
  • 必须
  • 单元更新基础属性集合
  • └ campaign_id
  • Number
  • 必须
  • 68796878069
  • 计划id
  • └ adgroup_id
  • Number
  • 必须
  • 68793666608
  • 单元id
  • └ material_id
  • Number
  • 可选
  • 714616513841
  • 物料id
  • └ display_status
  • String
  • 可选
  • pause
  • 前端展示状态,pause:暂停推广,start:正在推广,terminate:结束推广,wait:等待推广,pending:准备推广,wait_pay:计划未付款

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • adgroup_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • adgroup_v_o_list
  • AdgroupVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ campaign_name
  • String
  • 管家计划_宝贝候选集
  • 计划名称
  • └ adgroup_id
  • Number
  • 68793666608
  • 单元id
  • └ adgroup_name
  • String
  • ds460418344
  • 单元名称
  • └ online_status
  • Number
  • 0
  • 投放状态,-1:未进入投放状态,0:用户设置状态-下线,1:用户设置状态-上线,2:合同未生效,9:投放结束,105:待支付
  • └ display_status
  • String
  • pause
  • 前端展示状态,pause:暂停推广,start:正在推广,terminate:结束推广,wait:等待推广,pending:准备推广,wait_pay:计划未付款
  • └ audit_status
  • Number
  • 1
  • 风控审核状态,-1:待审核,0:后台下线状态,1:后台上线状态
  • └ audit_reason
  • String
  • xxxxx
  • 审核拒绝原因
  • adgroup_ocpc
  • AdgroupOcpcVO
  • 单元智能出价信息
  • └ enable_ocpc
  • Boolean
  • true
  • OCPC是否开启,false:否,true:是
  • └ ocpc_ratio
  • Number
  • 200
  • OCPC溢价比例
  • └ promotion_type
  • String
  • item
  • 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义;
  • └ sub_promotion_type
  • String
  • item
  • 推广子主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,you_hao_huo:有好货,picture:图文,short_video:短视频,live_room:直播间,live_spot:看点,tao_blocks:淘积木,user_define_url:自定义url
  • material
  • CommonMaterialVO
  • 通用主体VO
  • 主体类型对应的物料信息
  • └ material_id
  • Number
  • 714616513841
  • 物料id
  • └ material_type
  • Number
  • 1
  • 物料类型,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:内容平台-订阅内容
  • └ material_name
  • String
  • yiliantest测试请不要拍22
  • 物料名称
  • └ title
  • String
  • yiliantest测试请不要拍22
  • 标题
  • └ img_url
  • String
  • //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg
  • 图片地址
  • └ link_url
  • String
  • http://item.taobao.com/item.htm?id=715121254343
  • 跳转链接
  • └ price
  • String
  • 999900
  • 价格
  • └ bid_count
  • Number
  • 899900
  • 销量
  • └ quantity
  • Number
  • 10
  • 库存
  • └ first_starts_time
  • Date
  • 2023-04-26 14:51:03
  • 首次上架时间
  • └ starts
  • Date
  • 2023-04-26 14:51:03
  • 最近上架时间
  • └ category_id
  • String
  • 16 50010850
  • 主站类目路径,空格分隔多级
  • └ promotion_type
  • String
  • item
  • 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义;
  • └ sub_promotion_type
  • String
  • item
  • 推广子主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,you_hao_huo:有好货,picture:图文,short_video:短视频,live_room:直播间,live_spot:看点,tao_blocks:淘积木,user_define_url:自定义url
  • life_cycle_list
  • ItemLifeCycleViewVO []
  • 新品冷启期
  • 生命周期指标-越迁阶段列表,列表中最多有2个元素。在页面上展示的时候,按照元素的索引,从左到右依次展示即
  • └ life_cycle_desc
  • String
  • 新品打爆期
  • 周期文案
  • └ color
  • String
  • #36A2FC
  • 文案颜色
  • └ tips
  • String
  • 近30日GMV排名在叶子类目5%以内的新品
  • 周期提示文案
  • └ type
  • Number
  • 1
  • 生命周期类型
  • └ life_cycle_days
  • Number
  • 3
  • 生命周期指标-天数
  • └ life_cycle_diff_with_avg
  • String
  • 较慢
  • 生命周期指标-同叶子类目均值对比
  • └ life_cycle_diff_with_avg_tips
  • String
  • 快于同类目商品经历过同样阶段变化所用时间
  • 生命周期指标-同叶子类目均值对比提示文案
  • └ grow_desc
  • String
  • 日均再成交122.55元 可提高爆品类目排名卡位
  • 商品成长指标-成长文案
  • └ grow_rank
  • Number
  • 1077
  • 商品成长指标-成交排名
  • └ alive_group_id
  • Number
  • 0
  • 视频组件id,0:宝贝链接,3:订阅店铺,5:直播,6:加购,7:收藏加购,8:入会有礼,12:关注有礼,11:直播联动,10:自定义模板,13:同店搜
  • └ alive_group_name
  • String
  • 宝贝链接(默认)
  • 视频组件名称
  • └ black_creative_status
  • String
  • success
  • 智能创意生成状态,success:合成成功,fail:合成失败
  • └ error_count
  • Number
  • 10
  • 失败数量
  • error_details
  • TopFailResult []
  • 失败结果级
  • └ code
  • String
  • xxxxx
  • 业务失败编码
  • └ msg
  • String
  • xxxxx
  • 业务失败原因
  • result
  • AdgroupVO
  • 失败结果
  • └ adgroup_id
  • Number
  • 68793666608
  • 单元id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewAdgroupUpdatepartRequest req = new UniversalbpNewAdgroupUpdatepartRequest();
UniversalbpNewAdgroupUpdatepartRequest.TopServiceContext obj1 = new UniversalbpNewAdgroupUpdatepartRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartListVO obj2 = new UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartListVO();
List<UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartCommandVO> list4 = new ArrayList<UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartCommandVO>();
UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartCommandVO obj5 = new UniversalbpNewAdgroupUpdatepartRequest.AdgroupUpdatePartCommandVO();
list4.add(obj5);
obj5.setCampaignId(68796878069L);
obj5.setAdgroupId(68793666608L);
obj5.setMaterialId(714616513841L);
obj5.setDisplayStatus("pause");
obj2.setAdgroupList(list4);
req.setAdgroupUpdatePartListVO(obj2);
UniversalbpNewAdgroupUpdatepartResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_adgroup_updatepart_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <adgroup_v_o_top_bulk_data>
            <count>10</count>
            <adgroup_v_o_list>
                <adgroup_v_o>
                    <campaign_id>68796878069</campaign_id>
                    <campaign_name>管家计划_宝贝候选集</campaign_name>
                    <adgroup_id>68793666608</adgroup_id>
                    <adgroup_name>ds460418344</adgroup_name>
                    <online_status>0</online_status>
                    <display_status>pause</display_status>
                    <audit_status>1</audit_status>
                    <audit_reason>xxxxx</audit_reason>
                    <adgroup_ocpc>
                        <enable_ocpc>true</enable_ocpc>
                        <ocpc_ratio>200</ocpc_ratio>
                    </adgroup_ocpc>
                    <promotion_type>item</promotion_type>
                    <sub_promotion_type>item</sub_promotion_type>
                    <material>
                        <material_id>714616513841</material_id>
                        <material_type>1</material_type>
                        <material_name>yiliantest测试请不要拍22</material_name>
                        <title>yiliantest测试请不要拍22</title>
                        <img_url>//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg</img_url>
                        <link_url>http://item.taobao.com/item.htm?id=715121254343</link_url>
                        <price>999900</price>
                        <bid_count>899900</bid_count>
                        <quantity>10</quantity>
                        <first_starts_time>2023-04-26 14:51:03</first_starts_time>
                        <starts>2023-04-26 14:51:03</starts>
                        <category_id>16 50010850</category_id>
                        <promotion_type>item</promotion_type>
                        <sub_promotion_type>item</sub_promotion_type>
                        <life_cycle_list>
                            <item_life_cycle_view_v_o>
                                <life_cycle_desc>新品打爆期</life_cycle_desc>
                                <color>#36A2FC</color>
                                <tips>近30日GMV排名在叶子类目5%以内的新品</tips>
                                <type>1</type>
                            </item_life_cycle_view_v_o>
                        </life_cycle_list>
                        <life_cycle_days>3</life_cycle_days>
                        <life_cycle_diff_with_avg>较慢</life_cycle_diff_with_avg>
                        <life_cycle_diff_with_avg_tips>快于同类目商品经历过同样阶段变化所用时间</life_cycle_diff_with_avg_tips>
                        <grow_desc>日均再成交122.55元 可提高爆品类目排名卡位</grow_desc>
                        <grow_rank>1077</grow_rank>
                    </material>
                    <alive_group_id>0</alive_group_id>
                    <alive_group_name>宝贝链接(默认)</alive_group_name>
                    <black_creative_status>success</black_creative_status>
                </adgroup_v_o>
            </adgroup_v_o_list>
            <error_count>10</error_count>
            <error_details>
                <top_fail_result>
                    <code>xxxxx</code>
                    <msg>xxxxx</msg>
                    <result>
                        <adgroup_id>68793666608</adgroup_id>
                    </result>
                </top_fail_result>
            </error_details>
        </adgroup_v_o_top_bulk_data>
    </top_result>
</universalbp_new_adgroup_updatepart_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部