在商务中心解除 TikTok 账号与广告账号的关联
此接口可用于在商务中心解除 TikTok 账号与广告账号的关联。
TikTok 账号与广告账号解除关联后,有权访问该广告账号的商务中心成员将无法继续在该广告账号使用该 TikTok 账号投放广告。
准备工作
- 你需要成为商务中心的管理员。若要确认你对商务中心的权限,请使用 /bc/get/ 接口并确认返回的
user_role是否为ADMIN。 - 确保你之前已在商务中心将 TikTok 账号与广告账号关联。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/bc/asset/advertiser/unassign/
方法 POST
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br><br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br><br>允许值:`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}||
|---|---|---|
|bc_id {必填}|string|商务中心 ID。<br><br>若想获取你有权访问的商务中心列表,请使用 [/bc/get/](1737115687501826.html) 接口。|
|asset_id {必填}|string|商务中心内的 TikTok 账号 ID。<br><br>若需获取商务中心内的 TikTok 账号列表,请使用 [/bc/asset/get/](1739432717798401.html) 接口并将 `asset_type` 设置为 `TT_ACCOUNT` 或 `MANAGED_BUSINESS_ACCOUNT`。|
|asset_type {必填}|string|资产类型。<br><br>枚举值:<ul><li>`TT_ACCOUNT`:用于投放广告的 TikTok 账号。你可以使用这些 TikTok 账号投放广告。</li><li>`MANAGED_BUSINESS_ACCOUNT`:用于管理企业号的 TikTok 账号。你可以使用这些 TikTok 账号投放广告,并在你的 TikTok 账号中管理消息、线索、表单、评论、商品链接和洞察。</li></ul>|
|advertiser_id{必填}|string|同一商务中心内需与 TikTok 账号解除关联的广告账号 ID。<br><br>若需获取商务中心内已关联 TikTok 账号的广告账号列表,请使用 [/bc/asset/advertiser/assigned/](1855027294743554.html) 接口。|
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/bc/asset/advertiser/unassign/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"bc_id": "{{bc_id}}",
"asset_type": "MANAGED_BUSINESS_ACCOUNT",
"asset_id": "{{asset_id}}",
"advertiser_id": "{{advertiser_id}}"
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID,唯一标识一个请求。|
|data|object|返回数据。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)