根据资产获取成员

商务中心的管理员用户可以使用本接口获取对某资产有访问权限的成员列表。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/bc/asset/member/get/ | /v1.3/bc/asset/member/get/ | |请求参数类型|bc_id: number <br>asset_id: number |bc_id: string <br>asset_id: string | |返回参数类型|user_id: number |user_id: string | |新增返回参数|/|business_account_roles`|


## 请求

**地址**

https://business-api.tiktok.com/open_api/v1.3/bc/asset/member/get/

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心 ID。 |
|asset_type {必填}|string|资产类型。<br><br>枚举值：<ul><li>`ADVERTISER`：广告账号（广告主账号）。</li><li>`CATALOG`：商品库。</li><li>`LEAD`：线索。</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` 为 `MANAGED_BUSINESS_ACCOUNT`，此字段为商务中心内用于管理企业号的 TikTok 账号的 ID。</li></ul>|
| page | number | 当前页面。|
| page_size | number |页面大小。|
| filtering | object |筛选条件。|
#| keyword | string |筛选关键词。|

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "asset_type=ASSET_TYPE" \
--data-urlencode "asset_id=ASSET_ID" \
--data-urlencode "page=PAGE" \
--data-urlencode "page_size=PAGE_SIZE" \
--data-urlencode "filtering={\"keyword\": \"KEYWORD\"}" \
https://business-api.tiktok.com/open_api/v1.3/bc/asset/member/get/ 
(/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|返回数据。 |
#|list|object[]|成员列表。|
##| user_id | string |用户 ID。|
##| user_name | string |用户名称。|
##| advertiser_role | string | 仅当`asset_type` 为`ADVERTISER`时返回。<br><br>授予合作伙伴的广告账号角色。<br><br>枚举值： `ADMIN`, `OPERATOR`, `ANALYST`。|
##| catalog_role | string | 仅当`asset_type` 为 `CATALOG`时返回。<br><br>授予合作伙伴的商品库角色。<br><br>枚举值：<ul><li>`ADMIN`: 商务中心用户拥有商品库的管理权限。</li><li>`AD_PROMOTE`: 商务中心用户只能使用商品库进行推广活动。 </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>|
##| user_email | string |用户邮箱地址。|
#|page_info|object|分页信息。|
##|total_number|number|总结果数。|
##|total_page|number|总页数。|
##|page_size|number|页面大小。|
##|page|number|当前页面。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
} 
(/code)