主题
更新广告单元
需要携带 Token,详情看 Token
通过此接口可用于更新广告单元的基础信息,比如投放时间、投放地区等。
请求地址
https://{BASE_URL}/api/open/v3/offer
请求方法
PUT
请求示例
json
PUT /api/open/v3/offer
HTTP/1.1 Host: {BASE_URL}
Content-Type: application/json
{
"offer_id": "18490",
"offer_name": "cqf_testtttt",
"promote_timezone": 7,
"start_time": 1578455012,
"target_geo": "ALL"
}请求参数
| 字段 | 类型 | 说明 | 默认值 | 例子 |
|---|---|---|---|---|
| offer_id | int | 广告单元 ID | — | 1234 |
| offer_name | string | 广告单元名称,唯一。只允许数字字母下划线,字符长度 3~95。 | "" | "offer_test" |
| promote_timezone | number | 广告单元投放时间对应的时区,可选值:[枚举值 - 时区] | "" | 5.5 |
| start_time | int | 广告单元开始投放时间的时间戳,时间不得早于 2000 年(时间戳为 946656000)。 | — | 1578455012 |
| target_geo | string | 广告单元投放的地区,全部地区则写 "ALL",分地区用,分隔 | — | "CN" |
响应结果
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 200 表示成功,其他表示失败 |
| msg | string | 成功,返回"success",失败返回相应的错误信息 |
| data | json | 成功,返回广告单元信息,失败返回具体的错误信息 |
| offer_id | int | 广告单元 ID |
| offer_name | string | 广告单元名称 |
| promote_timezone | number | 广告单元投放时间对应的时区 |
| start_time | int | 广告单元开始投放时间的时间戳 |
| target_geo | string | 广告单元投放的地区 |
应答示例
json
{
"code": 200,
"msg": "success",
"data": {
"offer_id": 18496,
"offer_name": "cqf_testtttt",
"promote_timezone": 7,
"start_time": "1578455012",
"target_geo": "ALL"
}
}