API接口目录

广告业务

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

查看普通计划列表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY7777777操作用户id
nameStringNjack用户名称
startDateStringY2020-05-06推广开始日期
endDateStringY2020-05-06推广结束日期
promotionTypeStringY2商品推广类型 2:商品 4:店铺 5:一键 7:大聚惠 ,不在范围内默认查询2,4
statusStringY0推广计划状态 0:暂停 1:正常 ,-1不做状态校验不同于 PROMOTION_STATUS推广状态
orderByStringNshowNum排序字段 可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add();
pageNumStringN1当前页数
pagerSizeStringN10每页条数
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
accountUserIdString扣费用户id
agentTypeString0、无代理;1、代理商;2、代运营代理类型
allDealAmountString00
allDealOrderString00
allSubmitAmountString00
allSubmitOrderString00
avgClickCostString0平均点击消费
budgetString11推广计划日预算
clickNumString0点击率
clickPercentString0点击率
companyCodeString公司编码
cpcDayAmountStringnull
createDateString创建日期
createDateStrString创建日期字符串
dayCostString00
dealROIString00
endDateString1589904000000结束日期时间戳
endDateStrString2020-05-20结束日期时间字符串
isactiveString0 是,1 否推广计划是否删除
nameString智能词包_YW计划名称
operateUserIdString操作者id操作者id
productUserIdString广告主id广告主id
promotionIdString40053702计划id
promotionStatusString0:暂停推广余额不足, 1:正常推广状态
promotionTypeString2:商品 4:店铺 5:一键 7:大聚惠商品推广类型
recommendBaseBidString一键优选推荐坑位基础出价
searchBaseBidString一键优选搜索坑位基础出价
showNumString0展示量
startDateString1588089600000开始日期
startDateStrString2020-04-29开始日期字符串
statusString2状态
statusUpdateTimeString状态更新时间
statusUpdateTimeStrString状态更新时间字符串
submitROIString00
throwAreaString86投放地域
throwControlString投放平台
throwRebateString100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100
throwTimeString0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23投放时段
updateDateString1588142490000更新日期时间戳
updateDateStrString2020/4/29 14:41:30更新日期字符串
userIdString查询用户IDnull
userLimitAmountString推广计划日预算
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryGetpromotionlist>
      <promotionType>2</promotionType>
      <endDate>2020-05-06</endDate>
      <name>jack</name>
      <custnum>7777777</custnum>
      <orderBy>showNum</orderBy>
      <pageNum>1</pageNum>
      <startDate>2020-05-06</startDate>
      <status>0</status>
      <pagerSize>10</pagerSize>
    </queryGetpromotionlist>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryGetpromotionlist": {
        "promotionType": "2",
        "endDate": "2020-05-06",
        "name": "jack",
        "custnum": "7777777",
        "orderBy": "showNum",
        "pageNum": "1",
        "startDate": "2020-05-06",
        "status": "0",
        "pagerSize": "10"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryGetpromotionlist>
      <msg>成功</msg>
      <data>
        <allDealOrder>0</allDealOrder>
        <searchBaseBid>null</searchBaseBid>
        <updateDate>1588142490000</updateDate>
        <agentType>0、无代理;1、代理商;2、代运营</agentType>
        <allDealAmount>0</allDealAmount>
        <userLimitAmount>null</userLimitAmount>
        <endDate>1589904000000</endDate>
        <cpcDayAmount>null</cpcDayAmount>
        <updateDateStr>2020/4/29 14:41:30</updateDateStr>
        <isactive>0 是,1 否</isactive>
        <recommendBaseBid>null</recommendBaseBid>
        <throwArea>86</throwArea>
        <promotionId>40053702</promotionId>
        <allSubmitOrder>0</allSubmitOrder>
        <promotionStatus>0:暂停推广余额不足, 1:正常</promotionStatus>
        <dealROI>0</dealROI>
        <avgClickCost>0</avgClickCost>
        <productUserId>广告主id</productUserId>
        <submitROI>0</submitROI>
        <clickNum>0</clickNum>
        <endDateStr>2020-05-20</endDateStr>
        <accountUserId>null</accountUserId>
        <budget>11</budget>
        <createDate>null</createDate>
        <companyCode>null</companyCode>
        <promotionType>2:商品 4:店铺 5:一键 7:大聚惠</promotionType>
        <startDateStr>2020-04-29</startDateStr>
        <createDateStr>null</createDateStr>
        <throwRebate>100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100</throwRebate>
        <userId>null</userId>
        <statusUpdateTimeStr>null</statusUpdateTimeStr>
        <showNum>0</showNum>
        <throwTime>0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23</throwTime>
        <throwControl>null</throwControl>
        <allSubmitAmount>0</allSubmitAmount>
        <dayCost>0</dayCost>
        <name>智能词包_YW</name>
        <operateUserId>操作者id</operateUserId>
        <clickPercent>0</clickPercent>
        <startDate>1588089600000</startDate>
        <statusUpdateTime>null</statusUpdateTime>
        <status>2</status>
      </data>
      <status>0:成功,1:失败</status>
    </queryGetpromotionlist>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryGetpromotionlist": {
        "msg": "成功",
        "data": [
          {
            "allDealOrder": "0",
            "searchBaseBid": "null",
            "updateDate": "1588142490000",
            "agentType": "0、无代理;1、代理商;2、代运营",
            "allDealAmount": "0",
            "userLimitAmount": "null",
            "endDate": "1589904000000",
            "cpcDayAmount": "null",
            "updateDateStr": "2020/4/29 14:41:30",
            "isactive": "0 是,1 否",
            "recommendBaseBid": "null",
            "throwArea": "86",
            "promotionId": "40053702",
            "allSubmitOrder": "0",
            "promotionStatus": "0:暂停推广余额不足, 1:正常",
            "dealROI": "0",
            "avgClickCost": "0",
            "productUserId": "广告主id",
            "submitROI": "0",
            "clickNum": "0",
            "endDateStr": "2020-05-20",
            "accountUserId": "null",
            "budget": "11",
            "createDate": "null",
            "companyCode": "null",
            "promotionType": "2:商品 4:店铺 5:一键 7:大聚惠",
            "startDateStr": "2020-04-29",
            "createDateStr": "null",
            "throwRebate": "100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100,100",
            "userId": "null",
            "statusUpdateTimeStr": "null",
            "showNum": "0",
            "throwTime": "0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23",
            "throwControl": "null",
            "allSubmitAmount": "0",
            "dayCost": "0",
            "name": "智能词包_YW",
            "operateUserId": "操作者id",
            "clickPercent": "0",
            "startDate": "1588089600000",
            "statusUpdateTime": "null",
            "status": "2"
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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