撤销用户对资产的权限
管理员用户可以使用本接口撤销某用户对于资产的权限。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/bc/asset/unassign/|/v1.3/bc/asset/unassign/|
|请求参数类型 |bc_id: number <br>user_id: number<br>asset_id: number|bc_id: string <br>user_id: string<br>asset_id`: string|
## 请求
**地址** <https://business-api.tiktok.com/open_api/v1.3/bc/asset/unassign/>
**方法** POST
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权access_token,可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。 |
|Content-Type {必填}|string|请求信息类型。可选值:`"application/json"`。 |
参数
|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID |
|user_id {必填}|string| 您想要将撤销其对资产的权限的商务中心用户的ID。 <br>商务中心用户ID可通过[/bc/member/get/](https://ads.tiktok.com/marketing_api/docs?id=1739939404802049)返回的 `user_id`字段获取。|
|asset_type {必填}|string|资产类型。<br><br>枚举值:<ul><li>`ADVERTISER`:广告账号(广告主账号)。</li><li>`CATALOG`:商品库。</li><li>`LEAD`:线索。</li><li>`TT_ACCOUNT`:用于投放广告的 TikTok 账号。你可以使用这些 TikTok 账号投放广告。此资产类型与广告发布身份类型 `BC_AUTH_TT` 相对应。查看[广告发布身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)以了解更多信息。</li><li>`MANAGED_BUSINESS_ACCOUNT`:用于管理企业号的 TikTok 账号。你可以使用这些 TikTok 账号投放广告,并在你的 TikTok 账号中管理消息、线索、表单、评论、商品链接和洞察。</li></ul>|
|asset_id {必填}|string|资产 ID。<ul><li>如果 `asset_type` 为 `ADVERTISER`,此字段为广告主 ID。</li><li>如果 `asset_type` 为 `CATALOG`,此字段为商品库 ID。</li><li>如果 `asset_type` 为 `LEAD`,此字段为表单库 ID。若想获取你有权访问的表单库的更多详细信息,请使用 [/page/library/get/](1740029915327489.html) 接口。</li><li>如果 `asset_type` 为 `TT_ACCOUNT`,此字段为商务中心内用于投放广告的 TikTok 账号 ID。</li><li>如果 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT`,此字段为商务中心内用于管理企业号的 TikTok 账号的 ID。</li></ul>|
示例
(code cURL cURL)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/bc/asset/unassign/' \
--header 'Content-Type: application/json' \
--header 'Access-Token;' \
--data '{
"bc_id" : {{bc_id}},
"user_id": {{user_id}},
"asset_type": "ADVERTISER",
"asset_id": {{asset_id}}
}'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|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|返回数据。<br><br>如果请求成功,此字段将为空对象 (`{}`)。|
示例
(code cURL cURL)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)