文档中心 > API类目 > 直通车API

taobao.universalbp.material.accessallowed (物料准入判断)

入参推广信息,出参相关主体是否可投放。如果投放了风控不准入的商品,无法正常投放。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
material_access_allow_query_v_o MaterialAccessAllowQueryVo 必须 materialAccessAllowQueryVO
  • └ material_id_list
  • Number []
  • 可选
  • [714894818852, 714901906337]
  • 宝贝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:内容平台-订阅内容
  • └ need_qualification
  • Boolean
  • 可选
  • true
  • 是否需要校验资质,true:校验,false:不校验
  • └ 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

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • material_access_allow_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • material_access_allow_v_o_list
  • MaterialAccessAllowVo []
  • 批量结果集
  • └ material_id
  • Number
  • 714616513841
  • 物料id
  • └ access_allowed
  • Boolean
  • true
  • 是否通过准入,true:是,false:否
  • └ reason
  • String
  • 拒绝原因
  • 准入不通过原因
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpMaterialAccessallowedRequest req = new UniversalbpMaterialAccessallowedRequest();
UniversalbpMaterialAccessallowedRequest.TopServiceContext obj1 = new UniversalbpMaterialAccessallowedRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpMaterialAccessallowedRequest.MaterialAccessAllowQueryVo obj2 = new UniversalbpMaterialAccessallowedRequest.MaterialAccessAllowQueryVo();
obj2.setMaterialIdList(new Long[] { 714894818852, 714901906337 };
);
obj2.setMaterialType(1L);
obj2.setNeedQualification(true);
obj2.setPromotionType("item");
obj2.setSubPromotionType("item");
req.setMaterialAccessAllowQueryVO(obj2);
UniversalbpMaterialAccessallowedResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_material_accessallowed_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <material_access_allow_v_o_top_bulk_data>
            <material_access_allow_v_o_list>
                <material_access_allow_vo>
                    <material_id>714616513841</material_id>
                    <access_allowed>true</access_allowed>
                    <reason>拒绝原因</reason>
                </material_access_allow_vo>
            </material_access_allow_v_o_list>
            <count>1</count>
        </material_access_allow_v_o_top_bulk_data>
    </result>
</universalbp_material_accessallowed_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

返回
顶部