永久停用广告账户

您可以使用本接口永久停用商务中心中的广告账户。您必须是商务中心管理员用户。

推荐您不再需要使用某一广告账户时再进行永久停用账户的操作，因为一旦永久停用，广告账户将会被关闭，且广告账户将无法恢复到正常状态（即“审核通过”状态）。

使用前需知

仅当以下条件均满足时，您才可停用广告账户： - 您是商务中心的管理员用户。 - 您想停用的广告账户归该商务中心所有。 - 广告账户未处于永久停用状态或暂时禁用状态。 - 广告账户下三天内无在投广告。 - 广告账户下无未支付账单。 - 广告账户下无未完成的转账单。 - 若广告账户的付款类型为自动付款，则该账户下还需无未入账的消耗。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/disable/

方法 POST

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |
|Content-Type {必填}|string|请求消息类型<br>允许值: `"application/json"`。 |

参数

|字段{25%}|类型{15%}|描述{60%}|
|---|---|---|
| bc_id {必填} | string |商务中心ID。 |
| advertiser_ids {必填} | string[] |您想要永久停用的商务中心内广告账户的ID。最大数量为1。<br><p><span style="color:darkred"><b>重要提示</b></span>: 商务中心内广告账户停用后，广告账户的账户余额会转入所归属的商务中心中。|

示例

(code curl http)
curl --location --request POST ' https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/disable/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bc_id": "{{bc_id}}",
    "advertiser_ids": ["{{advertiser_id}}"]
}'
(/code)

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。  |
|message |string|返回信息。更多信息可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。  |
|data |object|返回数据  |
#| disabled_advertiser_ids |string[]| 已成功永久停用的广告账户的ID。 |
#| failed_infos | map<string, string[]>| 未成功永久停用的广告账户的相关信息。<br>键：未成功永久停用的广告账户的ID（`advertiser_id`）。<br>值：该广告账户未成功永久停用的原因。枚举值：<ul><li> `DELIVERING`：广告账户下三天内有在投广告。</li><li>`UNPAID_BILL`：广告账户下有未支付账单。</li><li>`SUSPENDED`：广告账户处于暂时禁用状态。</li><li>`UNFINISHED_TRANSFER`：广告账户下有未完成的转账单。</li><li>`AUTOPAY_UNBILLED`：该广告账户的付款类型为自动付款，且该账户下有未入账的消耗。</li></ul>|
|request_id |string|请求的日志ID，唯一标识一个请求。  |