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

taobao.universalbp.crowd.horizontal.modifystatus (修改人群状态)

修改指定计划、单元上的人群的投放状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
data_list CrowdRefCommandVo 必须 list
  • └ campaign_id
  • Number
  • 可选
  • 68799007001
  • 计划id,计划已经存在场景必填
  • └ adgroup_id
  • Number
  • 可选
  • 68796878061
  • 单元id,单元已经存在场景必填
  • └ crowd_id
  • Number
  • 可选
  • 5526396502
  • 人群主键id,人群已经存在场景必填
  • └ online_status
  • Number
  • 可选
  • 1
  • 定向状态,0:下线 1:上线
  • crowd
  • CrowdCommandVo
  • 可选
  • 人群
  • └ crowd_id
  • Number
  • 可选
  • 5526396502
  • 人群主键id,人群已经存在场景必填
  • └ crowd_name
  • String
  • 可选
  • 目标人群扩展
  • 人群名称
  • └ crowd_value
  • String
  • 可选
  • 2191820003
  • 人群值
  • └ target_type
  • Number
  • 可选
  • 130
  • 定向类型
  • label
  • LabelCommandVo
  • 可选
  • 定向标签
  • └ target_type
  • Number
  • 可选
  • 131
  • 定向标签类型
  • └ label_id
  • Number
  • 可选
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 可选
  • 关键词
  • 定向标签名称
  • └ label_desc
  • String
  • 可选
  • 关键词
  • 定向标签描述
  • └ label_value
  • String
  • 可选
  • 2000112
  • 定向标签值
  • option_list
  • OptionCommandVo []
  • 可选
  • 标签选项
  • └ option_name
  • String
  • 可选
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 可选
  • 2000123
  • 选项值
  • └ tag_id
  • Number
  • 可选
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • label_option_properties
  • LabelOptionProperties
  • 可选
  • 透传属性
  • └ dmp_option_group_id
  • String
  • 可选
  • 1001
  • dmp选项分组id
  • └ cate_name
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ cate_id
  • String
  • 可选
  • 714616513841
  • 物料id
  • └ lookalike_multiple
  • String
  • 可选
  • 1
  • 扩展倍数。低中高对应不同的倍数,由产品定义具体值,未来业务可支持滑动条。注意:倍数是指最终人数/种子人数,比如种子人群100万,扩展比种子多了50万,也就是总共150万,这时候扩展倍数是1.5而不是0.5
  • extend_seed_crowd_list
  • ExtendSeedCrowdRefCommandVo []
  • 可选
  • 种子人群关联信息
  • crowd
  • ExtendSeedCrowdCommandVo
  • 可选
  • 种子人群信息
  • └ crowd_id
  • Number
  • 可选
  • 5536708993
  • 人群主键id
  • └ crowd_name
  • String
  • 可选
  • 喜欢店铺新品的访客
  • 人群名称
  • label
  • ExtendSeedLabelCommandVo
  • 可选
  • 种子人群label信息
  • └ label_id
  • Number
  • 可选
  • 3000494
  • 定向标签id
  • └ label_name
  • String
  • 可选
  • 关键词
  • 定向标签名称
  • option_list
  • ExtendSeedOptionCommandVo []
  • 可选
  • 选项值信息
  • └ option_name
  • String
  • 可选
  • 人群特征继承
  • 选项名称
  • └ option_value
  • String
  • 可选
  • 2000123
  • 选项值
  • └ tag_id
  • Number
  • 可选
  • 100000
  • 选项id,(用于关键词推广静态标签生成人群)如基础属性人群标签组合
  • price
  • PriceCommandVo
  • 可选
  • 出价
  • └ bid_price
  • String
  • 可选
  • 30
  • 出价
  • └ discount
  • String
  • 可选
  • 30
  • 溢价

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • crowd_ref_update_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • crowd_ref_update_result_v_o_list
  • CrowdRefUpdateResultVo []
  • 批量结果集
  • └ campaign_id
  • Number
  • 68799007001
  • 计划id
  • └ adgroup_id
  • Number
  • 68796878061
  • 单元id
  • └ crowd_id
  • Number
  • 5526396502
  • 人群主键id
  • └ count
  • Number
  • 2
  • 更新成功数量
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCrowdHorizontalModifystatusRequest req = new UniversalbpCrowdHorizontalModifystatusRequest();
UniversalbpCrowdHorizontalModifystatusRequest.TopServiceContext obj1 = new UniversalbpCrowdHorizontalModifystatusRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCrowdHorizontalModifystatusRequest.CrowdRefCommandVo obj2 = new UniversalbpCrowdHorizontalModifystatusRequest.CrowdRefCommandVo();
obj2.setCampaignId(68799007001L);
obj2.setAdgroupId(68796878061L);
obj2.setCrowdId(5526396502L);
obj2.setOnlineStatus(1L);
UniversalbpCrowdHorizontalModifystatusRequest.CrowdCommandVo obj3 = new UniversalbpCrowdHorizontalModifystatusRequest.CrowdCommandVo();
obj3.setCrowdId(5526396502L);
obj3.setCrowdName("目标人群扩展");
obj3.setCrowdValue("2191820003");
obj3.setTargetType(130L);
UniversalbpCrowdHorizontalModifystatusRequest.LabelCommandVo obj4 = new UniversalbpCrowdHorizontalModifystatusRequest.LabelCommandVo();
obj4.setTargetType(131L);
obj4.setLabelId(3000494L);
obj4.setLabelName("关键词");
obj4.setLabelDesc("关键词");
obj4.setLabelValue("2000112");
List<UniversalbpCrowdHorizontalModifystatusRequest.OptionCommandVo> list6 = new ArrayList<UniversalbpCrowdHorizontalModifystatusRequest.OptionCommandVo>();
UniversalbpCrowdHorizontalModifystatusRequest.OptionCommandVo obj7 = new UniversalbpCrowdHorizontalModifystatusRequest.OptionCommandVo();
list6.add(obj7);
obj7.setOptionName("人群特征继承");
obj7.setOptionValue("2000123");
obj7.setTagId(100000L);
UniversalbpCrowdHorizontalModifystatusRequest.LabelOptionProperties obj9 = new UniversalbpCrowdHorizontalModifystatusRequest.LabelOptionProperties();
obj9.setDmpOptionGroupId("1001");
obj9.setCateName("714616513841");
obj9.setCateId("714616513841");
list8.setLabelOptionProperties(obj9);
obj4.setOptionList(list6);
UniversalbpCrowdHorizontalModifystatusRequest.LabelOptionProperties obj10 = new UniversalbpCrowdHorizontalModifystatusRequest.LabelOptionProperties();
obj10.setDmpOptionGroupId("1001");
obj10.setCateName("714616513841");
obj10.setCateId("714616513841");
obj4.setLabelOptionProperties(obj10);
obj3.setLabel(obj4);
obj3.setLookalikeMultiple("1");
List<UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdRefCommandVo> list12 = new ArrayList<UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdRefCommandVo>();
UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdRefCommandVo obj13 = new UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdRefCommandVo();
list12.add(obj13);
UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdCommandVo obj15 = new UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedCrowdCommandVo();
obj15.setCrowdId(5536708993L);
obj15.setCrowdName("喜欢店铺新品的访客");
UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedLabelCommandVo obj16 = new UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedLabelCommandVo();
obj16.setLabelId(3000494L);
obj16.setLabelName("关键词");
List<UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedOptionCommandVo> list18 = new ArrayList<UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedOptionCommandVo>();
UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedOptionCommandVo obj19 = new UniversalbpCrowdHorizontalModifystatusRequest.ExtendSeedOptionCommandVo();
list18.add(obj19);
obj19.setOptionName("人群特征继承");
obj19.setOptionValue("2000123");
obj19.setTagId(100000L);
obj16.setOptionList(list18);
obj15.setLabel(obj16);
list14.setCrowd(obj15);
obj3.setExtendSeedCrowdList(list12);
obj2.setCrowd(obj3);
UniversalbpCrowdHorizontalModifystatusRequest.PriceCommandVo obj20 = new UniversalbpCrowdHorizontalModifystatusRequest.PriceCommandVo();
obj20.setBidPrice("30");
obj20.setDiscount("30");
obj2.setPrice(obj20);
req.setDataList(obj2);
UniversalbpCrowdHorizontalModifystatusResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_crowd_horizontal_modifystatus_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <crowd_ref_update_result_v_o_top_bulk_data>
            <crowd_ref_update_result_v_o_list>
                <crowd_ref_update_result_vo>
                    <campaign_id>68799007001</campaign_id>
                    <adgroup_id>68796878061</adgroup_id>
                    <crowd_id>5526396502</crowd_id>
                    <count>2</count>
                </crowd_ref_update_result_vo>
            </crowd_ref_update_result_v_o_list>
            <count>1</count>
        </crowd_ref_update_result_v_o_top_bulk_data>
    </result>
</universalbp_crowd_horizontal_modifystatus_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

返回
顶部