API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.unit.update 编辑单元
¥免费

编辑单元

公共参数
请求参数
名称 类型 是否必须 示例值 描述
promotionUnitDtoStringN
custnumStringY6001849930操作者用户ID
promotionIdStringY40000008计划ID
promotionUnitIdStringY40000081单元ID
nameStringY大聚会推广单元名称
recommendPriceStringY200推荐广告位推荐基础出价
imgIndexStringY0图片位置索引LOCATION
ocpcStringYMap ocpcOCPC
matchModeStringYMap类型匹配模式
rankingsOrderStringYMapt抢排名设置
rankingsDiscountStringYMap溢价系数
rankingsButtonStringYMap类型一键抢排名
searchCrowdStringNMap搜索人群定向
commendCrowdStringNMap类型推荐人群定向
extFieldStringN
zncbPricePCStringN200智能词包pc出价
zncbPriceWAPStringN200智能词包无线出价
flowPackListStringN
flowTypeNameStringY购物前流量包
premiumStringY100溢价系数
flowTypeExplainStringY我的大促:把握大促会场流量,借力巨人肩膀流量包说明
flowTypeIdStringY1021属性编码
响应参数
名称 类型 示例值 描述
statusString0成功失败标志,1-成功 0-失败
msgString0返回信息,没有值返回null
dataString
promotionUnitIdString0第一个单元ID,失败时无该参数
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <updateUpdateunit>
      <promotionUnitDto>
        <rankingsButton>Map类型</rankingsButton>
        <rankingsDiscount>Map</rankingsDiscount>
        <custnum>6001849930</custnum>
        <commendCrowd>Map类型</commendCrowd>
        <promotionId>40000008</promotionId>
        <promotionUnitId>40000081</promotionUnitId>
        <imgIndex>0</imgIndex>
        <rankingsOrder>Map</rankingsOrder>
        <recommendPrice>200</recommendPrice>
        <ocpc>Map&lt;String,Object&gt; ocpc</ocpc>
        <searchCrowd>Map</searchCrowd>
        <name>大聚会</name>
        <flowPackList>
          <flowTypeName>购物前</flowTypeName>
          <premium>100</premium>
          <flowTypeExplain>我的大促:把握大促会场流量,借力巨人肩膀</flowTypeExplain>
          <flowTypeId>1021</flowTypeId>
        </flowPackList>
        <extField>
          <zncbPriceWAP>200</zncbPriceWAP>
          <zncbPricePC>200</zncbPricePC>
        </extField>
        <matchMode>Map类型</matchMode>
      </promotionUnitDto>
    </updateUpdateunit>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "updateUpdateunit": {
        "promotionUnitDto": {
          "rankingsButton": "Map类型",
          "rankingsDiscount": "Map",
          "custnum": "6001849930",
          "commendCrowd": "Map类型",
          "promotionId": "40000008",
          "promotionUnitId": "40000081",
          "imgIndex": "0",
          "rankingsOrder": "Map",
          "recommendPrice": "200",
          "ocpc": "Map ocpc",
          "searchCrowd": "Map",
          "name": "大聚会",
          "flowPackList": [
            {
              "flowTypeName": "购物前",
              "premium": "100",
              "flowTypeExplain": "我的大促:把握大促会场流量,借力巨人肩膀",
              "flowTypeId": "1021"
            }
          ],
          "extField": {
            "zncbPriceWAP": "200",
            "zncbPricePC": "200"
          },
          "matchMode": "Map类型"
        }
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <updateUpdateunit>
      <msg>0</msg>
      <data>
        <promotionUnitId>0</promotionUnitId>
      </data>
      <status>0</status>
    </updateUpdateunit>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "updateUpdateunit": {
        "msg": "0",
        "data": {
          "promotionUnitId": "0"
        },
        "status": "0"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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