更新升级版 Smart+ 广告组的预算

此接口可用于更新升级版 Smart+ 广告组的预算。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/budget/update/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求消息类型。<br>允许值：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|budget {+条件必填}|object[]|`budget` 和 `scheduled_budget` 必填其一。<ul><li>如需更新一个或多个广告组的预算，需指定 `budget`。</li><li>如需为一个或多个广告组的预算设置定时变更，需指定 `scheduled_budget`。</li></ul><br>你想为一个或多个广告组设置的新预算的相关信息。<br><br>最大数量：20。<br><br><p><span style="color:darkred"><b>注意</b></span>：对一个或多个广告组预算所做的更改会立即生效。|
#| adgroup_id {+条件必填}|string|指定了对象数组 `budget` 时，此为必填字段。<br><br>广告组 ID。|
#| budget {+条件必填}|float|指定了对象数组 `budget` 时，此为必填字段。<br><br>广告组的新预算。 |
| scheduled_budget {+条件必填}| object[] | `budget` 和 `scheduled_budget` 必填其一。<ul><li>如需更新一个或多个广告组的预算，需指定 `budget`。</li><li>如需为一个或多个广告组的预算设置定时变更，需指定 `scheduled_budget`。</li></ul><br>关于一个或多个广告组的定时预算调整列表信息。<br><br>最大数量：20。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>为升级版 Smart+ 广告组配置定时预算变更的功能目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>定时预算变更将在广告账号所在时区的次日凌晨 00:00 生效。</li></ul></p>|
#|adgroup_id {+条件必填}|string|指定了对象数组 `scheduled_budget` 时，此为必填字段。<br><br>广告组 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如果广告组 (`adgroup_id`) 属于启用推广系列预算优化的推广系列（即 `budget_optimize_on` 为 `true`），则必须配置 `min_budget`（最低日预算）或 `max_budget`（最高日预算），或两者同时配置。</li><li>对于未启用推广系列预算优化的推广系列中的广告组（即 `budget_optimize_on` 为 `false`），则没有此前提条件。</li></ul></p>|
#|scheduled_budget {+条件必填}|float|指定了对象数组 `scheduled_budget` 时，此为必填字段。<br><br>广告组 (`adgroup_id`) 的最高预算控制或新预算。<br><br><ul><li>对于启用推广系列预算优化的推广系列中的广告组（即 `budget_optimize_on` 为 `true`），必须配置 `min_budget`（最低日预算）或 `max_budget`（最高日预算），或两者同时配置。此字段将用于设置广告组的最高日预算。</li><li>对于未启用推广系列预算优化的推广系列中的广告组（即 `budget_optimize_on` 为 `false`），此字段用于设置广告组的动态日预算，无额外前提条件。</li></ul>|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/budget/update/' \
--header 'Access-Token: "{{Access-Token}}"' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "budget": [
        {
            "adgroup_id":"{{adgroup_id}}",
            "budget": "{{budget}}"
        },
        {
            "adgroup_id":"{{adgroup_id}}",
            "budget": "{{budget}}"
        }
    ]
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {}
}
(/code)