将资产分配给用户
商务中心的管理员用户可以使用本接口将资产分配给一个用户。该用户必须已在当前商务中心内。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/bc/asset/assign/|/v1.3/bc/asset/assign/|
|请求参数类型|bc_id: number <br>user_id: number<br>asset_id: number|bc_id: string<br>user_id: string<br>asset_id: string|
|新增请求参数 |/|store_role<br>business_account_roles`|
## 请求
**地址** <https://business-api.tiktok.com/open_api/v1.3/bc/asset/assign/>
**方法** 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><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>`TIKTOK_SHOP`：TikTok Shop。</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` 为 `TIKTOK_SHOP`，此字段为 TikTok Shop 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>|
|advertiser_role{+条件必填} |string|`asset_type` 为 `ADVERTISER`时必填。<br><br>广告账户角色。 角色为广告账户权限的第二层级。 <br><br>枚举值: `ADMIN`, `OPERATOR`, `ANALYST`. 更多关于广告账户权限的信息，请参考 [管理商务中心的权限](https://ads.tiktok.com/help/article?aid=12791)。|
|catalog_role{+条件必填}|string|`asset_type`为`CATALOG`时必填。<br><br>商务中心用户对于商品库的权限。 <br><br>枚举值：<ul><li> `ADMIN`: 商务中心用户对于商品库拥有管理员权限。 </li><li>`AD_PROMOTE`: 商务中心用户只能将商品库用于推广。</li>|
|form_library_role{+条件必填}|string|`asset_type`为`LEAD`时必填。<br><br>用户对于表单库的权限/角色。目前只支持`ADMIN`。|
|tt_account_roles {+条件必填}|string[]|当 `asset_type` 为 `TT_ACCOUNT` 时，此为必填字段。<br><br>商务中心用户对 TikTok 账号的广告投放权限。<br><br>枚举值：<ul><li>`POST`：现有帖子权限，包括访问自己的主页信息、公开视频，以及广告授权视频。</li><li>`LIVE`：直播视频权限（仅在部分地区可用），包括访问自己的主页信息和直播视频。</li><li>`DIRECT_MESSAGE`：私信权限，包括允许接收所有人向你发送的私信、阅读和管理收件箱中的私信，以及代表你向其他账号发送消息或与其他账号互动。</li></ul>|
|business_account_roles {+条件必填}|string[]|仅当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时，此为必填字段。<br><br>商务中心用户对 TikTok 账号的企业号管理权限。<br><br>枚举值：<ul><li>`BUSINESS_ACCOUNT_ADMIN`：企业号管理员。企业号管理员有权使用企业号的所有功能，包括验证、成员管理和关联商务中心。</li><li>`BUSINESS_ACCOUNT_OPERATOR`：企业号操作员。企业号操作员可以管理 TikTok 分析、帖子、消息和主页信息。</li><li>`BUSINESS_ACCOUNT_ANALYST`：企业号分析员。企业号分析员仅有权访问分析，无法管理帖子和消息等内容。</li></ul><br>最大数量：1。|
|store_role{+条件必填}|string|`asset_type`为 `TIKTOK_SHOP` 时必填。<br><br>商务中心用户对于店铺的权限。 枚举值：<ul><li>`AD_PROMOTION`: 商务中心用户只能将 TikTok Shop 店铺用于推广。</li></ul>|
示例
(code cURL cURL)
curl --location --request POST 'business-api.tiktok.com/open_api/v1.3/bc/asset/assign/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"bc_id": "{{bc_id}}",
"user_id": "{{user_id}}",
"asset_type": "ADVERTISER",
"asset_id": "{{asset_id}}",
"advertiser_role": "ADMIN"
}'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?rid=0h3hwv7v4gzs&id=1737172488964097) 。 |
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?rid=0h3hwv7v4gzs&id=1737172488964097)。<br><br><p><span style="color:darkred"><b>注意</b></span>：若返回码为`40002`，且返回信息为"Authorization roles exceed the role range that the BC can manage.", 则需要检查请求中传入`advertiser_role`， `catalog_role`， `form_library_role`，或 `tt_account_roles`的值是否是允许值。 |
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data| object | 返回数据。|
示例
(code cURL cURL)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)