API接口目录

广告业务

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

查询计划下单元列表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY777777操作用户id
goodsCodeStringN10456777商品编码
startDateStringYyyyy-MM-dd开始日期
endDateStringYyyyy-MM-dd结束日期
orderByStringN可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);排序字段
nameStringN大促计划名称
promotionIdStringN4444444计划id
promotionTypeStringN可为空,-1或为空查询全部计划类型
promotionStatusStringY-2推广状态
unitStatusStringY-1 0:暂停推广,1:正在推广单元状态
pageNumStringN1当前页数
pagerSizeStringN10每页条数
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
allDealAmountString0总成交金额
allDealOrderString0总成交订单数
allSubmitAmountString0总提交金额
allSubmitOrderString0总提交订单数
avgClickCostString0平均点击消费
brandIdString品牌ID
brandNameString品牌名称
budgetString10日预算
categoryString类目列表
clickNumString0点击量
clickPercentString0点击率
commendCrowdString推荐广告位人群
crowdInfoString用户人群标签列表
dayCostString0日花费
dealROIString0成交ROI
flowPackListString流量包列表
generalCmmdtyCodeString商品通码
goodsString商品列表
goodsCodeString000000000826369677商品编码
goodsImgStringhttp://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000000826369677_1.jpg商品图片
goodsInfoString商品信息
goodsNameString商品名称
goodsPriceString商品价格
goodsSalePointString商品卖点
goodsSalePointExtString处理后的商品卖点
goodsSalePointExtTypeString1:卖点 2:评价处理后的商品卖点类型
goodsUrlString商品URL
imgIndexString0图片位置索引LOCATION
imgsString
illegalFlagString1非法标识
pictureLocationString2图片位置
pictureUrlStringhttp://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h图片地址
isactiveString0 是,1 否是否删除
linkUrlStringhttp://productxgpre.cnsuning.com/0070060496/826369677.html商品着陆页URL
matchModeString
itemCodeString1001产品编号
itemValueString1产品值
matchModeValueString2匹配编码值
nameStringC店汽车配件商品四季垫新港PRE联调001推广单元名称
ocpcStringocpc
ocpcValueString1ocpc值
promotionIdString40053701推广计划ID
promotionNameStringadtjs_测试3推广计划名称
promotionStatusString 2推广状态
promotionTypeString2:商品 4:店铺 5:一键 7:大聚惠推广类型
promotionUnitIdString40044467推广单元ID
rankingsButtonString一键抢排名
rankingsDiscountString2溢价系数
rankingsOrderString说明:取top3溢价订单
recommendPriceString1000推荐基础出价(单位:分)
recommendPriceYuanString10推荐基础出价(单位:元)
searchCrowdString搜索广告位人群
shopIdString12店铺ID
shopInfoString店铺信息
showNumString0展示量
statusString2状态
submitROIString0提交ROI
unitStatusString1单元状态
updateTimeString1588128527706更新时间
updateTimeStrStringyyyy-MM-dd HH:mm:ss更新时间字符串
userIdString429053726查询用户ID
wapLinkUrlStringhttps://productxgpre.m.cnsuning.com/product/0070060496/826369677.htmlwap商品着陆页URL
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryUnitlist>
      <promotionType>可为空,-1或为空查询全部</promotionType>
      <endDate>yyyy-MM-dd</endDate>
      <name>大促</name>
      <custnum>777777</custnum>
      <orderBy>可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);</orderBy>
      <goodsCode>10456777</goodsCode>
      <pageNum>1</pageNum>
      <startDate>yyyy-MM-dd</startDate>
      <promotionId>4444444</promotionId>
      <promotionStatus>-2</promotionStatus>
      <unitStatus>-1  0:暂停推广,1:正在推广</unitStatus>
      <pagerSize>10</pagerSize>
    </queryUnitlist>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryUnitlist": {
        "promotionType": "可为空,-1或为空查询全部",
        "endDate": "yyyy-MM-dd",
        "name": "大促",
        "custnum": "777777",
        "orderBy": "可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum);",
        "goodsCode": "10456777",
        "pageNum": "1",
        "startDate": "yyyy-MM-dd",
        "promotionId": "4444444",
        "promotionStatus": "-2",
        "unitStatus": "-1  0:暂停推广,1:正在推广",
        "pagerSize": "10"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryUnitlist>
      <msg>成功</msg>
      <data>
        <goodsImg>http://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000000826369677_1.jpg</goodsImg>
        <goodsSalePointExtType>1:卖点 2:评价</goodsSalePointExtType>
        <goods>null</goods>
        <commendCrowd>null</commendCrowd>
        <matchModeValue>2</matchModeValue>
        <promotionId>40053701</promotionId>
        <promotionStatus> 2</promotionStatus>
        <dealROI>0</dealROI>
        <imgIndex>0</imgIndex>
        <wapLinkUrl>https://productxgpre.m.cnsuning.com/product/0070060496/826369677.html</wapLinkUrl>
        <linkUrl>http://productxgpre.cnsuning.com/0070060496/826369677.html</linkUrl>
        <shopId>12</shopId>
        <goodsName>null</goodsName>
        <matchMode>
          <itemCode>1001</itemCode>
          <itemValue>1</itemValue>
        </matchMode>
        <budget>10</budget>
        <updateTimeStr>yyyy-MM-dd HH:mm:ss</updateTimeStr>
        <imgs>
          <pictureLocation>2</pictureLocation>
          <pictureUrl>http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h</pictureUrl>
          <illegalFlag>1</illegalFlag>
        </imgs>
        <brandName>null</brandName>
        <shopInfo>null</shopInfo>
        <rankingsButton>null</rankingsButton>
        <goodsSalePoint>null</goodsSalePoint>
        <rankingsOrder>说明:取top3</rankingsOrder>
        <goodsUrl>null</goodsUrl>
        <searchCrowd>null</searchCrowd>
        <brandId>null</brandId>
        <dayCost>0</dayCost>
        <goodsPrice>null</goodsPrice>
        <name>C店汽车配件商品四季垫新港PRE联调001</name>
        <ocpcValue>1</ocpcValue>
        <clickPercent>0</clickPercent>
        <crowdInfo>null</crowdInfo>
        <goodsInfo>null</goodsInfo>
        <status>2</status>
        <allDealOrder>0</allDealOrder>
        <allDealAmount>0</allDealAmount>
        <isactive>0 是,1 否</isactive>
        <allSubmitOrder>0</allSubmitOrder>
        <unitStatus>1</unitStatus>
        <promotionUnitId>40044467</promotionUnitId>
        <promotionName>adtjs_测试3</promotionName>
        <recommendPrice>1000</recommendPrice>
        <avgClickCost>0</avgClickCost>
        <submitROI>0</submitROI>
        <flowPackList>null</flowPackList>
        <clickNum>0</clickNum>
        <goodsSalePointExt>null</goodsSalePointExt>
        <recommendPriceYuan>10</recommendPriceYuan>
        <promotionType>2:商品 4:店铺 5:一键 7:大聚惠</promotionType>
        <rankingsDiscount>2</rankingsDiscount>
        <updateTime>1588128527706</updateTime>
        <generalCmmdtyCode>null</generalCmmdtyCode>
        <userId>429053726</userId>
        <showNum>0</showNum>
        <ocpc>null</ocpc>
        <allSubmitAmount>0</allSubmitAmount>
        <goodsCode>000000000826369677</goodsCode>
        <category>null</category>
      </data>
      <status>0:成功,1:失败</status>
    </queryUnitlist>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryUnitlist": {
        "msg": "成功",
        "data": [
          {
            "goodsImg": "http://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000000826369677_1.jpg",
            "goodsSalePointExtType": "1:卖点 2:评价",
            "goods": "null",
            "commendCrowd": "null",
            "matchModeValue": "2",
            "promotionId": "40053701",
            "promotionStatus": " 2",
            "dealROI": "0",
            "imgIndex": "0",
            "wapLinkUrl": "https://productxgpre.m.cnsuning.com/product/0070060496/826369677.html",
            "linkUrl": "http://productxgpre.cnsuning.com/0070060496/826369677.html",
            "shopId": "12",
            "goodsName": "null",
            "matchMode": [
              {
                "itemCode": "1001",
                "itemValue": "1"
              }
            ],
            "budget": "10",
            "updateTimeStr": "yyyy-MM-dd HH:mm:ss",
            "imgs": [
              {
                "pictureLocation": "2",
                "pictureUrl": "http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h",
                "illegalFlag": "1"
              }
            ],
            "brandName": "null",
            "shopInfo": "null",
            "rankingsButton": "null",
            "goodsSalePoint": "null",
            "rankingsOrder": "说明:取top3",
            "goodsUrl": "null",
            "searchCrowd": "null",
            "brandId": "null",
            "dayCost": "0",
            "goodsPrice": "null",
            "name": "C店汽车配件商品四季垫新港PRE联调001",
            "ocpcValue": "1",
            "clickPercent": "0",
            "crowdInfo": "null",
            "goodsInfo": "null",
            "status": "2",
            "allDealOrder": "0",
            "allDealAmount": "0",
            "isactive": "0 是,1 否",
            "allSubmitOrder": "0",
            "unitStatus": "1",
            "promotionUnitId": "40044467",
            "promotionName": "adtjs_测试3",
            "recommendPrice": "1000",
            "avgClickCost": "0",
            "submitROI": "0",
            "flowPackList": "null",
            "clickNum": "0",
            "goodsSalePointExt": "null",
            "recommendPriceYuan": "10",
            "promotionType": "2:商品 4:店铺 5:一键 7:大聚惠",
            "rankingsDiscount": "2",
            "updateTime": "1588128527706",
            "generalCmmdtyCode": "null",
            "userId": "429053726",
            "showNum": "0",
            "ocpc": "null",
            "allSubmitAmount": "0",
            "goodsCode": "000000000826369677",
            "category": "null"
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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