更新广告单元

需要携带 Token，详情看 Token

通过此接口可用于更新广告单元的基础信息，比如投放时间、投放地区等。

请求地址

https://ss-api.mintegral.com/api/open/v1/offer

请求方法

PUT

请求示例

PUT /api/open/v1/offer
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": "18490",
  "offer_name": "cqf_testtttt",
  "promote_timezone": 7,
  "start_time": 1578455012,
  "target_geo": "ALL",
  "os_version_min": "8.8",
  "custom_ad_schedule": {"1":"0,1,23","2":"3,4,5","3":"3,6,5"},
  "custom_ad_schedule_timezone": 0,
  "network": "WIFI",
  "target_device": "PHONE"
}

请求参数

字段	类型	说明	默认值	例子
offer_id	int	广告单元 ID	—	1234
offer_name	string	广告单元名称，唯一。只允许数字字母下划线，字符长度 3~95。	""	"offer_test"
promote_timezone	number	广告单元投放时间对应的时区，可选值：[枚举值 - 时区]	""	5.5
start_time	int	广告单元开始投放时间的时间戳，时间不得早于 2000 年（时间戳为 946656000）。如果填写了 end_time 的话，start_time 必须小于 end_time。	—	1578455012
end_time 选填	int	广告单元结束投放时间的时间戳，必须晚于 start_time。	0	1578455169
target_geo	string	广告单元投放的地区，全部地区则写 "ALL"，分地区用,分隔	—	"CN"
os_version_min 选填	string	投放设备要求的系统最低版本。格式为 /^[0-9](\.[0-9]){0,2}$/ 。如果没传，默认使用关联广告的 min_version。	—	"9.0"
custom_ad_schedule 选填	json	广告投放的日程。key 表示周一到周日(1-7)，value 表示 0 点到 23 点(0-23)。默认为空值，代表所有。	—	{"1":"0,1,23","2":"3,4,5"}
custom_ad_schedule_timezone 已弃用	number	投放日程的时区。可选值：[枚举值 - 时区] 此字段已被弃用，使用 'promote_timezone' 字段代替。	—	-5.5
network 选填	string	网络类型定向。可选值：[枚举值 - 网络类型]	—	"2G,3G,4G,5G"
target_device 选填	string	设备类型定向。多个用,号分隔。可选值："PHONE" 、"TABLET"。	"PHONE,TABLET"	"PHONE,TABLET"

响应结果

字段	类型	说明
code	int	200 表示成功，其他表示失败
msg	string	成功，返回"success"，失败返回相应的错误信息
data	json	成功，返回广告单元信息，失败返回具体的错误信息
offer_id	int	广告单元 ID
offer_name	string	广告单元名称
promote_timezone	number	广告单元投放时间对应的时区
start_time	int	广告单元开始投放时间的时间戳
end_time	int	广告单元结束投放时间的时间戳
target_geo	string	广告单元投放的地区
os_version_min	string	投放设备要求的系统最低版本
custom_ad_schedule	string	广告投放的日程
custom_ad_schedule_timezone	number	投放日程的时区 此字段已被弃用，使用 'promote_timezone' 字段代替。
network	string	网络状态定向
target_device	string	设备类型定向

应答示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "offer_id": 18496,
    "offer_name": "cqf_testtttt",
    "promote_timezone": 7,
    "start_time": "1578455012",
    "end_time": "1578458012",
    "target_geo": "ALL",
    "os_version_min": "8.8",
    "custom_ad_schedule": {"1":"0,1,23","2":"3,4,5","3":"3,6,5"},
    "custom_ad_schedule_timezone": 0,
    "network": "WIFI",
    "target_device": "PHONE"
  }
}