更新广告组日限额信息
开发环境
开发环境
POST
/v1.3/adgroups/update_daily_budget
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| account_id* | integer | 广告主帐号 id，有操作权限的帐号 id，不支持代理商 id |
| update_daily_budget_spec* | struct[] | 更新日限额条件 数组最大长度 100 |
| adgroup_id* | int64 | 广告组 id |
| daily_budget* | integer | 日预算，单位为分，对于微信朋友圈广告（campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS）：日预算要求介于 100,000 – 4,000,000,000 分之间（1,000 元-40,000,000 元，单位为人民币）；修改后的日预算不能低于该广告组今日已消耗金额的 1.5 倍；每次修改幅度不能低于 5,000 分（50 元，单位为人民币）。 对于非微信朋友圈广告（campaign_type ！= CAMPAIGN_TYPE_WECHAT_MOMENTS）：日预算需介于 5,000 分-4,000,000,000 分之间（50 元-4,000,000 元，单位为人民币）；每次修改幅度不能低于该 adgroup 今日已消耗金额加上 5,000 分（50 元，单位为人民币）；每次修改幅度不能低于 5,000 分（50 元，单位为人民币）；每天每广告组最多修改 1,000 次。 |
使用说明 1.返回结果的顺序和 update_daily_budget_spec 中的参数顺序是一致的。 2.update_daily_budget_spec 中 adgroup_id 不允许重复。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/adgroups/update_daily_budget' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'update_daily_budget_spec=[{"adgroup_id":123,"daily_budget":1000000},{"adgroup_id":456,"daily_budget":5000000}]'响应示例响应示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"code": 0,
"message": "",
"message_cn": "",
"adgroup_id": "<ADGROUP_ID>"
}
],
"fail_id_list": []
}
}请求参数
Header 参数
access_token
string
必需
默认值:
<ACCESS_TOKEN>
timestamp
string
必需
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59
默认值:
<TIMESTAMP>
nonce
string
必需
默认值:
<NONCE>
Body 参数application/x-www-form-urlencoded
account_id
integer
必需
示例值:
<ACCOUNT_ID>
update_daily_budget_spec
string
必需
数组最大长度 100
示例值:
[{"adgroup_id":123,"daily_budget":1000000},{"adgroup_id":456,"daily_budget":5000000}]
返回响应
修改于 2023-11-07 02:55:59