工具 API

bc_asset_assign

Assigns a Business Center asset to a TikTok For Business user who already belongs to the same Business Center. You must be an Admin user of the Business Center to call this endpoint. In v1.3, the endpoint path changed from `/v1.2/bc/asset/assign/` to `/v1.3/bc/asset/assign/`, `bc_id`, `user_id`, and `asset_id` changed from number to string, and `store_role` and `business_account_roles` were added.

ecommerceOAuth1 积分

调用信息

工具标识
tiktok-ads.bc_asset_assign
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

advertiser_role

Required when `asset_type` is `ADVERTISER`. Role to assign on the advertiser account, equivalent to Layer 2 of Ad Account Permissions.

asset_id必填

ID of the asset to assign. Its meaning depends on `asset_type`: if `ADVERTISER`, this is the advertiser ID; if `CATALOG`, the catalog ID; if `TIKTOK_SHOP`, the TikTok Shop ID; if `LEAD`, the form library ID; if `TT_ACCOUNT`, the ID of a TikTok account as an ad delivery asset in a Business Center; if `MANAGED_BUSINESS_ACCOUNT`, the ID of a TikTok account for Business Account management in a Business Center. For `LEAD`, you can use `/page/library/get/` to obtain form library details and IDs you have access to.

asset_type必填

Type of asset being assigned. Determines the meaning of `asset_id` and which companion role field is required: `ADVERTISER` requires `advertiser_role`; `CATALOG` requires `catalog_role`; `TIKTOK_SHOP` requires `store_role`; `LEAD` requires `form_library_role`; `TT_ACCOUNT` requires `tt_account_roles`; `MANAGED_BUSINESS_ACCOUNT` requires `business_account_roles`. `TT_ACCOUNT` is a TikTok account used as an ad delivery asset and corresponds to identity type `BC_AUTH_TT`. `MANAGED_BUSINESS_ACCOUNT` is a TikTok account for Business Account management, allowing ads plus management of messages, leads, forms, comments, product links, and insights.

bc_id必填

Business Center ID.

business_account_roles

Required only when `asset_type` is `MANAGED_BUSINESS_ACCOUNT`. Business Account management permission to assign on the TikTok account. Max size: 1.

catalog_role

Required when `asset_type` is `CATALOG`. Business Center user's permission for the catalog.

form_library_role

Required when `asset_type` is `LEAD`. Form library role assigned to the user. Currently only `ADMIN` is supported.

store_role

Required when `asset_type` is `TIKTOK_SHOP`. Business Center user's permission for the TikTok Shop.

tt_account_roles

Required when `asset_type` is `TT_ACCOUNT`. Ad delivery permissions to assign on the TikTok account. `LIVE` is only available in some regions.

user_id必填

ID of the Business Center user to assign the asset to. Obtain this value from the `user_id` returned by `/bc/member/get/`.