cainiao.pickup.business.adv.get (菜鸟商家寄件获取营销文案信息)

当我们跟外部平台(可能是企业)合作时,如果外部企业给我们一块广告位,我们需要把这些信息展示给外部平台。API用户获取广告信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
location String 可选 bannerAdv
  • 默认值:bannerAdv
  • 查询某个位置上需要展示的广告,线下约定入参

    响应参数

    名称 类型 示例值 描述
    result TdOpenServiceResult {} 返回结果
    • data_list
    • MarketingSenseEntryInfo
    • {}
    • 返回对象
    • └ resource_url
    • String
    • https://www.google.com/search?q=mtop.cainiao.billing.price.query&oq=mtop.cainiao.billing.price.query&aqs=chrome..69i57j69i60.3542j0j4&sourceid=chrome&ie=UTF-8
    • 点击resource的落地页,为空表示不能点击
    • └ resource
    • String
    • https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg
    • 营销信息可能是通过一个图片或者其它资源来展示,展示需要图片地址,采用该地址进行展示
    • └ benefit_url
    • String
    • https://www.google.com/search?q=mtop.cainiao.billing.price.query&oq=mtop.cainiao.billing.price.query&aqs=chrome..69i57j69i60.3542j0j4&sourceid=chrome&ie=UTF-8
    • 利益点落地页,为空表示不能点击
    • └ location
    • String
    • bannerAdv
    • 双方约定展示的位置入参
    • └ copy
    • String
    • 上门揽收,当日取件
    • 营销文案
    • └ title
    • String
    • 3月特惠寄
    • 该营销广告信息的title
    • └ extent_info
    • String
    • 扩展信息示例
    • 预留为扩展信息
    • └ benefit
    • String
    • 限时特惠
    • 利益点展示
    • └ copy_url
    • String
    • https://www.google.com/search?q=mtop.cainiao.billing.price.query&oq=mtop.cainiao.billing.price.query&aqs=chrome..69i57j69i60.3542j0j4&sourceid=chrome&ie=UTF-8
    • 利益点落地页,为空表示不能展示
    • └ success
    • Boolean
    • true
    • 请求是否成功
    • └ retry
    • Boolean
    • false
    • 是否需要重试
    • └ status_code
    • String
    • SYSTEM_ERROR
    • 错误码
    • └ status_message
    • String
    • 系统异常
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoPickupBusinessAdvGetRequest req = new CainiaoPickupBusinessAdvGetRequest();
    req.setLocation("bannerAdv");
    CainiaoPickupBusinessAdvGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_pickup_business_adv_get_response>
        <result>
            <data_list>
                <resource_url>https://www.google.com/search?q=mtop.cainiao.billing.price.query&amp;oq=mtop.cainiao.billing.price.query&amp;aqs=chrome..69i57j69i60.3542j0j4&amp;sourceid=chrome&amp;ie=UTF-8</resource_url>
                <resource>https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg</resource>
                <benefit_url>https://www.google.com/search?q=mtop.cainiao.billing.price.query&amp;oq=mtop.cainiao.billing.price.query&amp;aqs=chrome..69i57j69i60.3542j0j4&amp;sourceid=chrome&amp;ie=UTF-8</benefit_url>
                <location>bannerAdv</location>
                <copy>上门揽收,当日取件</copy>
                <title>3月特惠寄</title>
                <extent_info>扩展信息示例</extent_info>
                <benefit>限时特惠</benefit>
                <copy_url>https://www.google.com/search?q=mtop.cainiao.billing.price.query&amp;oq=mtop.cainiao.billing.price.query&amp;aqs=chrome..69i57j69i60.3542j0j4&amp;sourceid=chrome&amp;ie=UTF-8</copy_url>
            </data_list>
            <success>true</success>
            <retry>false</retry>
            <status_code>SYSTEM_ERROR</status_code>
            <status_message>系统异常</status_message>
        </result>
    </cainiao_pickup_business_adv_get_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

    返回
    顶部