Skip to content

更新广告单元

需要携带 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_idint广告单元 ID1234
offer_namestring广告单元名称,唯一。只允许数字字母下划线,字符长度 3~95。"""offer_test"
promote_timezonenumber广告单元投放时间对应的时区,可选值:[枚举值 - 时区]""5.5
start_timeint广告单元开始投放时间的时间戳,时间不得早于 2000 年(时间戳为 946656000)。1578455012
target_geostring广告单元投放的地区,全部地区则写 "ALL",分地区用,分隔"CN"

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回广告单元信息,失败返回具体的错误信息
offer_idint广告单元 ID
offer_namestring广告单元名称
promote_timezonenumber广告单元投放时间对应的时区
start_timeint广告单元开始投放时间的时间戳
target_geostring广告单元投放的地区

应答示例

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "offer_id": 18496,
    "offer_name": "cqf_testtttt",
    "promote_timezone": 7,
    "start_time": "1578455012",
    "target_geo": "ALL"
  }
}

Algogear OpenAPI 文档