查询计划下单元列表
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
custnum | String | Y | 777777 | 操作用户id |
goodsCode | String | N | 10456777 | 商品编码 |
startDate | String | Y | yyyy-MM-dd | 开始日期 |
endDate | String | Y | yyyy-MM-dd | 结束日期 |
orderBy | String | N | 可为空,默认按更新时间倒序,可自己设置的排序字段如下:orderByFields.add(showNum); | 排序字段 |
name | String | N | 大促 | 计划名称 |
promotionId | String | N | 4444444 | 计划id |
promotionType | String | N | 可为空,-1或为空查询全部 | 计划类型 |
promotionStatus | String | Y | -2 | 推广状态 |
unitStatus | String | Y | -1 0:暂停推广,1:正在推广 | 单元状态 |
pageNum | String | N | 1 | 当前页数 |
pagerSize | String | N | 10 | 每页条数 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | String | 0:成功,1:失败 | 状态 |
msg | String | 成功 | 状态说明 |
data | String | ||
allDealAmount | String | 0 | 总成交金额 |
allDealOrder | String | 0 | 总成交订单数 |
allSubmitAmount | String | 0 | 总提交金额 |
allSubmitOrder | String | 0 | 总提交订单数 |
avgClickCost | String | 0 | 平均点击消费 |
brandId | String | 品牌ID | |
brandName | String | 品牌名称 | |
budget | String | 10 | 日预算 |
category | String | 类目列表 | |
clickNum | String | 0 | 点击量 |
clickPercent | String | 0 | 点击率 |
commendCrowd | String | 推荐广告位人群 | |
crowdInfo | String | 用户人群标签列表 | |
dayCost | String | 0 | 日花费 |
dealROI | String | 0 | 成交ROI |
flowPackList | String | 流量包列表 | |
generalCmmdtyCode | String | 商品通码 | |
goods | String | 商品列表 | |
goodsCode | String | 000000000826369677 | 商品编码 |
goodsImg | String | http://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000000826369677_1.jpg | 商品图片 |
goodsInfo | String | 商品信息 | |
goodsName | String | 商品名称 | |
goodsPrice | String | 商品价格 | |
goodsSalePoint | String | 商品卖点 | |
goodsSalePointExt | String | 处理后的商品卖点 | |
goodsSalePointExtType | String | 1:卖点 2:评价 | 处理后的商品卖点类型 |
goodsUrl | String | 商品URL | |
imgIndex | String | 0 | 图片位置索引LOCATION |
imgs | String | ||
illegalFlag | String | 1 | 非法标识 |
pictureLocation | String | 2 | 图片位置 |
pictureUrl | String | http://sit1image.suning.cn/uimg/b2c/newcatentries/0070056935-000000000000000000_2.jpg_200w_200h | 图片地址 |
isactive | String | 0 是,1 否 | 是否删除 |
linkUrl | String | http://productxgpre.cnsuning.com/0070060496/826369677.html | 商品着陆页URL |
matchMode | String | ||
itemCode | String | 1001 | 产品编号 |
itemValue | String | 1 | 产品值 |
matchModeValue | String | 2 | 匹配编码值 |
name | String | C店汽车配件商品四季垫新港PRE联调001 | 推广单元名称 |
ocpc | String | ocpc | |
ocpcValue | String | 1 | ocpc值 |
promotionId | String | 40053701 | 推广计划ID |
promotionName | String | adtjs_测试3 | 推广计划名称 |
promotionStatus | String | 2 | 推广状态 |
promotionType | String | 2:商品 4:店铺 5:一键 7:大聚惠 | 推广类型 |
promotionUnitId | String | 40044467 | 推广单元ID |
rankingsButton | String | 一键抢排名 | |
rankingsDiscount | String | 2 | 溢价系数 |
rankingsOrder | String | 说明:取top3 | 溢价订单 |
recommendPrice | String | 1000 | 推荐基础出价(单位:分) |
recommendPriceYuan | String | 10 | 推荐基础出价(单位:元) |
searchCrowd | String | 搜索广告位人群 | |
shopId | String | 12 | 店铺ID |
shopInfo | String | 店铺信息 | |
showNum | String | 0 | 展示量 |
status | String | 2 | 状态 |
submitROI | String | 0 | 提交ROI |
unitStatus | String | 1 | 单元状态 |
updateTime | String | 1588128527706 | 更新时间 |
updateTimeStr | String | yyyy-MM-dd HH:mm:ss | 更新时间字符串 |
userId | String | 429053726 | 查询用户ID |
wapLinkUrl | String | https://productxgpre.m.cnsuning.com/product/0070060496/826369677.html | wap商品着陆页URL |
<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" } } } }
<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:失败" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.advertise.queryunitlist.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.adss | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |