API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.editunitindex.query 查询单元详细数据
¥免费

查询单元详细数据

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY54321用户id
unitIdStringY123456单元id
cityIdStringY投放地区
appliCodeStringN342345商家编码
userTypeStringN4用户类型
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
promotionUnitIdString8880001000002140推广单元ID
promotionIdString50000150推广计划ID
userIdString428964304查询用户ID
isactiveString0 是,1 否是否删除
brandIdString000150EOF品牌ID
brandNameString巴宝莉修改test1001(Burberry1001)品牌名称
goodsCodeString12223商品编码
generalCmmdtyCodeString344567894商品通码
goodsUrlStringdefault商品URL
goodsNameString耐克商品名称
goodsPriceString100商品价格
recommendPriceString200推荐基础出价
goodsSalePointString卖点商品卖点
goodsSalePointExtString便宜处理后的商品卖点
goodsSalePointExtTypeString1:卖点 2:评价处理后的商品卖点类型
imgIndexString0图片位置索引LOCATION
linkUrlStringwww.baidu.com商品着陆页URL
nameString推广推广单元名称
statusString0:暂停推广,1:正在推广推广单元状态
updateTimeString1588158440000更新时间
matchModeString
itemCodeString"1001"商品编码
itemValueString“1”商品值
ocpcString
itemCodeString"1005"商品编码
itemValueString“1”商品值
imgsString
illegalFlagString1非法标识
pictureLocationString2图片位置索引LOCATION
pictureUrlString"http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h"图片地址
categoryString
categoryCodeString"20006"商品类目编码
categoryNameString"手机"商品类目名称
crowdInfoString
crowdIdString"200402"人群标签ID
crowdNameString"223"人群标签名称
coverNumString"30000"覆盖人群数
selectedString0未选中 1选中是否选中标志位
typeString0 搜索广告位,1 推荐广告位类型
overPriceIndexString1010-1000溢价系数
flowPackListString
flowTypeExplainString"深度浏览,助力引流、拉新"流量包类型说明
flowTypeIdString"1018"流量包类型ID
flowTypeNameString"购物前"流量包类型名称
premiumString"0"溢价系数
goodsInfoString
goodsCodeString"10160302529"商品编码
goodsNameString"飞利浦"商品名称
goodsPriceString1000商品价格
goodsStatusString1商品状态
rankingsOrderString
itemCodeString"1002"商品编码
itemValueString"top3"商品值
rankingsDiscountString
itemCodeString"1003"商品编码
itemValueString"10"商品值
rankingsButtonString
itemCodeString"1004"商品编码
itemValueString"1"商品值
extFieldString
zncbPricePCString100智能词包pc出价
zncbPriceWAPString100智能词包无线出价
ideaString
ideaIdString11
pictureIdString11
urlString11
titleString11
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryEditunitindex>
      <appliCode>342345</appliCode>
      <custnum>54321</custnum>
      <unitId>123456</unitId>
      <cityId>群</cityId>
      <userType>4</userType>
    </queryEditunitindex>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryEditunitindex": {
        "appliCode": "342345",
        "custnum": "54321",
        "unitId": "123456",
        "cityId": "群",
        "userType": "4"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryEditunitindex>
      <msg>成功</msg>
      <data>
        <goodsSalePointExtType>1:卖点 2:评价</goodsSalePointExtType>
        <isactive>0 是,1 否</isactive>
        <promotionId>50000150</promotionId>
        <promotionUnitId>8880001000002140</promotionUnitId>
        <imgIndex>0</imgIndex>
        <recommendPrice>200</recommendPrice>
        <linkUrl>www.baidu.com</linkUrl>
        <flowPackList>
          <flowTypeName>"购物前"</flowTypeName>
          <premium>"0"</premium>
          <flowTypeExplain>"深度浏览,助力引流、拉新"</flowTypeExplain>
          <flowTypeId>"1018"</flowTypeId>
        </flowPackList>
        <goodsSalePointExt>便宜</goodsSalePointExt>
        <extField>
          <idea>
            <pictureId>1</pictureId>
            <title>1</title>
            <url>1</url>
            <ideaId>1</ideaId>
          </idea>
          <zncbPriceWAP>100</zncbPriceWAP>
          <zncbPricePC>100</zncbPricePC>
        </extField>
        <goodsName>耐克</goodsName>
        <matchMode>
          <itemCode>"1001"</itemCode>
          <itemValue>“1”</itemValue>
        </matchMode>
        <imgs>
          <pictureLocation>2</pictureLocation>
          <pictureUrl>"http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h"</pictureUrl>
          <illegalFlag>1</illegalFlag>
        </imgs>
        <brandName>巴宝莉修改test1001(Burberry1001)</brandName>
        <rankingsButton>
          <itemCode>"1004"</itemCode>
          <itemValue>"1"</itemValue>
        </rankingsButton>
        <rankingsDiscount>
          <itemCode>"1003"</itemCode>
          <itemValue>"10"</itemValue>
        </rankingsDiscount>
        <updateTime>1588158440000</updateTime>
        <generalCmmdtyCode>344567894</generalCmmdtyCode>
        <userId>428964304</userId>
        <goodsSalePoint>卖点</goodsSalePoint>
        <rankingsOrder>
          <itemCode>"1002"</itemCode>
          <itemValue>"top3"</itemValue>
        </rankingsOrder>
        <goodsUrl>default</goodsUrl>
        <ocpc>
          <itemCode>"1005"</itemCode>
          <itemValue>“1”</itemValue>
        </ocpc>
        <brandId>000150EOF</brandId>
        <goodsPrice>100</goodsPrice>
        <name>推广</name>
        <goodsCode>12223</goodsCode>
        <category>
          <categoryCode>"20006"</categoryCode>
          <categoryName>"手机"</categoryName>
        </category>
        <crowdInfo>
          <coverNum>"30000"</coverNum>
          <type>0 搜索广告位,1 推荐广告位</type>
          <crowdId>"200402"</crowdId>
          <overPriceIndex>10</overPriceIndex>
          <selected>0未选中 1选中</selected>
          <crowdName>"223"</crowdName>
        </crowdInfo>
        <goodsInfo>
          <goodsStatus>1</goodsStatus>
          <goodsPrice>1000</goodsPrice>
          <goodsCode>"10160302529"</goodsCode>
          <goodsName>"飞利浦"</goodsName>
        </goodsInfo>
        <status>0:暂停推广,1:正在推广</status>
      </data>
      <status>0:成功,1:失败</status>
    </queryEditunitindex>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryEditunitindex": {
        "msg": "成功",
        "data": [
          {
            "goodsSalePointExtType": "1:卖点 2:评价",
            "isactive": "0 是,1 否",
            "promotionId": "50000150",
            "promotionUnitId": "8880001000002140",
            "imgIndex": "0",
            "recommendPrice": "200",
            "linkUrl": "www.baidu.com",
            "flowPackList": [
              {
                "flowTypeName": "\"购物前\"",
                "premium": "\"0\"",
                "flowTypeExplain": "\"深度浏览,助力引流、拉新\"",
                "flowTypeId": "\"1018\""
              }
            ],
            "goodsSalePointExt": "便宜",
            "extField": [
              {
                "idea": [
                  {
                    "pictureId": "1",
                    "title": "1",
                    "url": "1",
                    "ideaId": "1"
                  }
                ],
                "zncbPriceWAP": "100",
                "zncbPricePC": "100"
              }
            ],
            "goodsName": "耐克",
            "matchMode": [
              {
                "itemCode": "\"1001\"",
                "itemValue": "“1”"
              }
            ],
            "imgs": [
              {
                "pictureLocation": "2",
                "pictureUrl": "\"http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h\"",
                "illegalFlag": "1"
              }
            ],
            "brandName": "巴宝莉修改test1001(Burberry1001)",
            "rankingsButton": [
              {
                "itemCode": "\"1004\"",
                "itemValue": "\"1\""
              }
            ],
            "rankingsDiscount": [
              {
                "itemCode": "\"1003\"",
                "itemValue": "\"10\""
              }
            ],
            "updateTime": "1588158440000",
            "generalCmmdtyCode": "344567894",
            "userId": "428964304",
            "goodsSalePoint": "卖点",
            "rankingsOrder": [
              {
                "itemCode": "\"1002\"",
                "itemValue": "\"top3\""
              }
            ],
            "goodsUrl": "default",
            "ocpc": [
              {
                "itemCode": "\"1005\"",
                "itemValue": "“1”"
              }
            ],
            "brandId": "000150EOF",
            "goodsPrice": "100",
            "name": "推广",
            "goodsCode": "12223",
            "category": [
              {
                "categoryCode": "\"20006\"",
                "categoryName": "\"手机\""
              }
            ],
            "crowdInfo": [
              {
                "coverNum": "\"30000\"",
                "type": "0 搜索广告位,1 推荐广告位",
                "crowdId": "\"200402\"",
                "overPriceIndex": "10",
                "selected": "0未选中 1选中",
                "crowdName": "\"223\""
              }
            ],
            "goodsInfo": [
              {
                "goodsStatus": "1",
                "goodsPrice": "1000",
                "goodsCode": "\"10160302529\"",
                "goodsName": "\"飞利浦\""
              }
            ],
            "status": "0:暂停推广,1:正在推广"
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.advertise.queryeditunitindex.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.adss 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ