API接口目录

广告业务

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

查询计划投放地域

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY777777操作用户id
promotionIdStringY40053702计划id
响应参数
名称 类型 示例值 描述
statusString状态0:成功,1:失败
msgString"成功"状态说明
dataString
cpcDayAmountString
defaultUserLimitAmountString7777默认日预算
customDataString
dateString300日期
dateStrString"app"日期字符串
userLimitAmountString10用户限制金额
promotionIdString40053702推广计划ID
throwRebateString"0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0"分时折扣
throwAreaString"10 100 110 120 130 140 150 160 170 190 20 200 210 220 230 240 250 260 270 280 290 30 300 320 40 50 60 70 80 90"投放地域
throwTimeString"0 1 2 3 4 5 6 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23"投放时段
throwControlString
throwDiscountString300投放折扣
positiontypeString"app"地区类型
promotionIdString123推广计划ID
nameString5推广计划名称
userIdString"23"查询用户ID
statusUpdateTimeStrStringyyyy-MM-dd HH:mm:ss状态更新时间
promotionStatusString"成功"推广状态
statusString0:暂停 1:正常推广计划状态
createDateStrStringyyyy-MM-dd HH:mm:ss创建日期
createDateString1588142490000创建日期
updateDateStrStringyyyy-MM-dd HH:mm:ss更新日期
updateDateString1588142490000更新日期
promotionTypeString2:商品 4:店铺 5:一键 7:大聚惠推广类型
userLimitAmountString10推广计划日预算
startDateStrString日期格式:yyyy-MM-dd推广开始日期字符串
startDateString1588142490000推广开始日期时间戳
endDateStrString日期格式:yyyy-MM-dd推广结束日期字符串
endDateString1588142490000推广结束日期时间戳
isactiveString0 是,1 否推广计划是否删除
searchBaseBidString“500”一键优选搜索坑位基础出价
recommendBaseBidString“300”一键优选推荐坑位基础出价
operateUserIdString“2”操作者id
productUserIdString“2”广告主id
accountUserIdString“3”扣费用户id
agentTypeString0、无代理;1、代理商;2、代运营代理类型
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryEditpromotionindex>
      <custnum>777777</custnum>
      <promotionId>40053702</promotionId>
    </queryEditpromotionindex>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryEditpromotionindex": {
        "custnum": "777777",
        "promotionId": "40053702"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryEditpromotionindex>
      <msg>"成功"</msg>
      <data>
        <searchBaseBid>“500”</searchBaseBid>
        <updateDate>1588142490000</updateDate>
        <userLimitAmount>10</userLimitAmount>
        <agentType>0、无代理;1、代理商;2、代运营</agentType>
        <endDate>1588142490000</endDate>
        <updateDateStr>yyyy-MM-dd HH:mm:ss</updateDateStr>
        <cpcDayAmount>
          <defaultUserLimitAmount>7777</defaultUserLimitAmount>
          <customData>
            <date>300</date>
            <userLimitAmount>10</userLimitAmount>
            <dateStr>"app"</dateStr>
          </customData>
          <promotionId>40053702</promotionId>
        </cpcDayAmount>
        <isactive>0 是,1 否</isactive>
        <recommendBaseBid>“300”</recommendBaseBid>
        <throwArea>"10 100 110 120 130 140 150 160 170 190 20 200 210 220 230 240 250 260 270 280 290 30 300 320 40 50 60 70 80 90"</throwArea>
        <promotionId>123</promotionId>
        <promotionStatus>"成功"</promotionStatus>
        <productUserId>“2”</productUserId>
        <endDateStr>日期格式:yyyy-MM-dd</endDateStr>
        <createDate>1588142490000</createDate>
        <accountUserId>“3”</accountUserId>
        <promotionType>2:商品 4:店铺 5:一键 7:大聚惠</promotionType>
        <startDateStr>日期格式:yyyy-MM-dd</startDateStr>
        <createDateStr>yyyy-MM-dd HH:mm:ss</createDateStr>
        <throwRebate>"0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0"</throwRebate>
        <userId>"23"</userId>
        <statusUpdateTimeStr>yyyy-MM-dd HH:mm:ss</statusUpdateTimeStr>
        <throwTime>"0 1 2 3 4 5 6 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23"</throwTime>
        <throwControl>
          <positiontype>"app"</positiontype>
          <throwDiscount>300</throwDiscount>
        </throwControl>
        <name>5</name>
        <operateUserId>“2”</operateUserId>
        <startDate>1588142490000</startDate>
        <status>0:暂停 1:正常</status>
      </data>
      <status>状态</status>
    </queryEditpromotionindex>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryEditpromotionindex": {
        "msg": "\"成功\"",
        "data": [
          {
            "searchBaseBid": "“500”",
            "updateDate": "1588142490000",
            "userLimitAmount": "10",
            "agentType": "0、无代理;1、代理商;2、代运营",
            "endDate": "1588142490000",
            "updateDateStr": "yyyy-MM-dd HH:mm:ss",
            "cpcDayAmount": [
              {
                "defaultUserLimitAmount": "7777",
                "customData": [
                  {
                    "date": "300",
                    "userLimitAmount": "10",
                    "dateStr": "\"app\""
                  }
                ],
                "promotionId": "40053702"
              }
            ],
            "isactive": "0 是,1 否",
            "recommendBaseBid": "“300”",
            "throwArea": "\"10 100 110 120 130 140 150 160 170 190 20 200 210 220 230 240 250 260 270 280 290 30 300 320 40 50 60 70 80 90\"",
            "promotionId": "123",
            "promotionStatus": "\"成功\"",
            "productUserId": "“2”",
            "endDateStr": "日期格式:yyyy-MM-dd",
            "createDate": "1588142490000",
            "accountUserId": "“3”",
            "promotionType": "2:商品 4:店铺 5:一键 7:大聚惠",
            "startDateStr": "日期格式:yyyy-MM-dd",
            "createDateStr": "yyyy-MM-dd HH:mm:ss",
            "throwRebate": "\"0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0\"",
            "userId": "\"23\"",
            "statusUpdateTimeStr": "yyyy-MM-dd HH:mm:ss",
            "throwTime": "\"0 1 2 3 4 5 6 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23\"",
            "throwControl": [
              {
                "positiontype": "\"app\"",
                "throwDiscount": "300"
              }
            ],
            "name": "5",
            "operateUserId": "“2”",
            "startDate": "1588142490000",
            "status": "0:暂停 1:正常"
          }
        ],
        "status": "状态"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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