请输入
菜单

更新广告单元

需要携带 Token，详情看Token

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

请求地址

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

请求方法

PUT

请求示例

json 复制代码 
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 设备类型定向

应答示例

json 复制代码 
{
  "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"
  }
}
上一个
创建广告单元
下一个
更新出价
最近修改: 2025-06-23