cainiao.pickup.business.adv.carousel.get (菜鸟商家寄件获取营销文案轮播信息(支持PC,移动多端的信息获取)菜鸟商家寄件获取营销文案信息(支持PC,移动多端的信息获取))

菜鸟商家寄件获取营销文案轮播信息(支持PC,移动多端的信息获取)菜鸟商家寄件获取营销文案信息(支持PC,移动多端的信息获取)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
external_platform_request ExternalPlatformRequest 可选 ISV身份入参
  • └ biz_type
  • String
  • 可选
  • ISVMerchant
  • 业务类型
location String 可选 bannerAdv 查询某个位置上需要展示的广告,线下约定入参
order_operation_person OrderOperationPerson 可选 用户身份
  • └ mobile
  • String
  • 可选
  • 13817778888
  • 下单操作人的手机号,用作联系,可以不填写

响应参数

名称 类型 示例值 描述
result TdOpenServiceResult 返回结果
  • data
  • MarketingSenseEntryInfoCarousel
  • 返回对象
  • mobile_list
  • MarketingSenseEntryInfo []
  • 移动端营销文案展示
  • └ resource_url
  • String
  • http://xxx
  • 点击营销文案资源时的跳转链接,为空表示不附带链接
  • └ resource
  • String
  • https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg
  • 营销文案的资源展示(一般是图片链接)
  • └ benefit_url
  • String
  • http://xxx
  • 利益点详细信息链接,为空表示不附带链接
  • └ copy
  • String
  • 上门揽收,当日取件
  • 营销文案
  • └ title
  • String
  • 3月特惠寄
  • 该营销文案的标题
  • └ 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
  • 营销文案附带链接,为空表示不附带链接
  • pc_list
  • MarketingSenseEntryInfo []
  • PC端营销文案展示
  • └ resource_url
  • String
  • http://xxx
  • 点击营销文案资源时的跳转链接,为空表示不附带链接
  • └ resource
  • String
  • https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg
  • 营销文案的资源展示(一般是图片链接)
  • └ benefit_url
  • String
  • http://xxx
  • 利益点详细信息链接,为空表示不附带链接
  • └ copy
  • String
  • 上门揽收,当日取件
  • 营销文案
  • └ title
  • String
  • 3月特惠寄
  • 该营销文案的标题
  • └ 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
  • 营销文案附带链接,为空表示不附带链接
  • └ retry
  • Boolean
  • false
  • 重试

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoPickupBusinessAdvCarouselGetRequest req = new CainiaoPickupBusinessAdvCarouselGetRequest();
CainiaoPickupBusinessAdvCarouselGetRequest.ExternalPlatformRequest obj1 = new CainiaoPickupBusinessAdvCarouselGetRequest.ExternalPlatformRequest();
obj1.setBizType("ISVMerchant");
req.setExternalPlatformRequest(obj1);
req.setLocation("bannerAdv");
CainiaoPickupBusinessAdvCarouselGetRequest.OrderOperationPerson obj2 = new CainiaoPickupBusinessAdvCarouselGetRequest.OrderOperationPerson();
obj2.setMobile("13817778888");
req.setOrderOperationPerson(obj2);
CainiaoPickupBusinessAdvCarouselGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_pickup_business_adv_carousel_get_response>
    <result>
        <data>
            <mobile_list>
                <marketing_sense_entry_info>
                    <resource_url>http://xxx</resource_url>
                    <resource>https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg</resource>
                    <benefit_url>http://xxx</benefit_url>
                    <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>
                </marketing_sense_entry_info>
            </mobile_list>
            <pc_list>
                <marketing_sense_entry_info>
                    <resource_url>http://xxx</resource_url>
                    <resource>https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg</resource>
                    <benefit_url>http://xxx</benefit_url>
                    <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>
                </marketing_sense_entry_info>
            </pc_list>
        </data>
        <retry>false</retry>
    </result>
</cainiao_pickup_business_adv_carousel_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

返回
顶部