获取资产列表

您可以使用本接口获取商务中心下您或者某个用户拥有权限的资产信息。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/bc/asset/get/|/v1.3/bc/asset/get/| |请求参数类型 |bc_id: number|bc_id: string| |新增请求参数|/|keyword: string| |返回参数类型|asset_id: number|asset_id: string| |新增返回参数|/|advertiser_account_type store_role ad_creation_eligible business_account_roles is_business_verified operating_region_code tt_asset_handle tt_asset_profile_image`|


## 请求

**地址**  https://business-api.tiktok.com/open_api/v1.3/bc/asset/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>`TIKTOK_SHOP`：TikTok Shop。</li><li>`PIXEL`：Pixel。</li><li>`LEAD`：线索。</li><li>`TT_ACCOUNT`：用于投放广告的 TikTok 账号。你可以使用这些 TikTok 账号投放广告。此资产类型与广告发布身份类型 `BC_AUTH_TT` 相对应。查看[广告发布身份](1738958351620097.html)以了解更多信息。</li><li>`MANAGED_BUSINESS_ACCOUNT`：用于管理企业号的 TikTok 账号。你可以使用这些 TikTok 账号投放广告，并在你的 TikTok 账号中管理消息、线索、表单、评论、商品链接和洞察。</li></ul>|
|filtering|object|筛选条件。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不能同时使用 `user_id` 和 `user_email`。</li><li>若未传入任何筛选值，系统会在 `user_id` 字段传入为你提供授权码 (`auth_code`) 的 TikTok for Business 账号的用户 ID。</li></ul>|
#|user_id|string|要获取其资产的用户的 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不能同时设置 `user_id` 和 `user_mail`。</li><li>对于状态为 `BOUND` 的用户，请使用 `user_id` 获取其资产。</li><li>对于状态为 `PENDING` 的用户，请使用 `user_email` 获取其资产。</li><li>当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时，不支持此筛选条件。</li></ul>|
#|user_email|string|要获取其资产的用户的电子邮箱。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>不能同时设置`user_id` 和 `user_mail` 。</li><li>对于状态为 `BOUND` 的用户，请使用 `user_id` 获取其资产。</li><li>对于状态为 `PENDING` 的用户，请使用 `user_email` 获取其资产。</li><li>仅当你已将 `asset_type` 设为 `ADVERTISER`，且邀请用户加入商务中心的请求仍处于待处理状态时，才可将 `user_email` 用作筛选条件。</li><li>当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时，不支持此筛选条件。</li></ul>|
#|keyword|string|你正在查找的资产的关键词。<br><br><p><span style="color:darkred"><b>注意</b></span>：当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时，不支持此筛选条件。|
|page|number| 当前页数。<br><br>默认值: 1。|
|page_size|number|分页大小。<br><br>取值范围：1-50。<br>默认值：10。|

示例

(code CURL curl)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/bc/asset/get/?bc_id={{bc_id}}&asset_type=ADVERTISER' \
--header 'Access-Token: {{Access-Token}}
(/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)。 |
|data |object|返回数据。 |
#|list|object[]|资产列表。|
##|asset_type|string|资产类型。<br><br>枚举值：<ul><li>`ADVERTISER`：广告账号（广告主账号）。</li><li>`CATALOG`：商品库。</li><li>`TIKTOK_SHOP`：TikTok Shop。</li><li>`PIXEL`：Pixel。</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` 为 `PIXEL`，此字段为 Pixel 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>|
##|asset_name|string|资产名称。|
##|advertiser_account_type |string|广告账户类型。<br><br>枚举值：`RESERVATION` （合约广告账户），`AUCTION`（竞价广告账户）。|
##|advertiser_role |string|商务中心用户对于广告账户的权限。<br><br>枚举值：<ul><li>`ADMIN`：管理员。管理广告账号财务、设置和权限。 创建和编辑广告推广系列并查看投放效果数据。</li><li>`OPERATOR`：操作员。创建和编辑广告推广系列并查看投放效果数据。</li><li>`ANALYST`：分析师。查看广告和投放效果数据。</li></ul><br>仅当`asset_type`为`ADVERTISER`时，本字段返回非 null 值。|
##|catalog_role|string|  商务中心用户对于商品库的权限。<br><br>枚举值：<ul><li> `ADMIN`：商品库管理。可以通过自然内容和广告内容推广商品，也可以修改商品和商品库。 </li><li>`AD_PROMOTE`：广告推广。使用商品库创建广告。</li></ul><br>仅当`asset_type`为`CATALOG`时，本字段返回非 null 值。|
##|ad_creation_eligible |string|仅当 `asset_type` 为 `CATALOG` 时返回本字段。<br><br>商品库中含有广告样式所需的足量可用商品时，商品库是否可用于广告中。<br><br>枚举值：<ul><li>`NOT_AVAILABLE`: 商品库不可用于广告中。</li><li>`AVAILABLE`: 若商品库中含有广告样式所需的足量可用商品，商品库可用于广告中。</li></ul>|
##|store_role|string|商务中心用户对于 TikTok Shop 的权限。 <br><br>枚举值：<ul><li>`AD_PROMOTION`: 广告推广。创建广告来推广此 TikTok Shop 的商品。</li></ul><br>仅当`asset_type` 为 `TIKTOK_SHOP` 时，本字段返回非 null 值。|
##|tt_account_roles|string[]|商务中心用户对 TikTok 账号的广告投放权限。<br><br>枚举值：<ul><li>`POST`：现有帖子权限，包括访问自己的主页信息、公开视频，以及广告授权视频。</li><li>`LIVE`：直播视频权限（仅在部分地区可用），包括访问自己的主页信息和直播视频。</li><li>`DIRECT_MESSAGE`：私信权限，包括允许接收所有人向你发送的私信、阅读和管理收件箱中的私信，以及代表你向其他账号发送消息或与其他账号互动。</li></ul>此字段在 `asset_type` 为 `TT_ACCOUNT` 时返回非空值。|
##|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>|
##|owner_bc_name|string|拥有此资产的商务中心。<br><br>当 `asset_type` 为 `TT_ACCOUNT` 或 `MANAGED_BUSINESS_ACCOUNT` 时，此字段的值将为空。|
##|is_business_verified|boolean|仅当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时返回。<br><br>TikTok 账号是否为已通过验证的企业号。<br>认证徽章可以证明账号的真实性，我们会根据你的活动以及你提供的信息决定是否授予你认证徽章。拥有已通过验证的账号，还能获得额外的保护、直接的支持，以及更高的曝光度。<br><br>支持的值：`true`、`false`。<br><br><p><span style="color:darkred"><b>注意</b></span>：在商务中心创建的机构号将有权使用已完成认证的企业号的专属功能，例如企业套件功能。对于这些账号，企业认证将直接获得批准，无需提供任何企业认证文件。这些账号的 `is_business_verified` 将为 `true`。|
##|operating_region_code|string|仅当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时返回。<br><br>TikTok 账号运营地区的地区代码。<br><br>示例：`US`。<br><br>枚举值参见 [`operating_region_code` 值列表](https://business-api.tiktok.com/portal/docs?id=1855027199571138#item-link-operating_region_code 值列表)。|
##|tt_asset_handle|string|仅当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时返回。<br><br>TikTok 账号的用户名|
##|tt_asset_profile_image|string|仅当 `asset_type` 为 `MANAGED_BUSINESS_ACCOUNT` 时返回。<br><br>TikTok 账号的头像。<br><br>如果没有为 TikTok 账号传入头像，此字段将为空。|
#|page_info|object| 分页信息。|
##|page|number| 当前页码。|
##|page_size| number | 页大小。|
##|total_number| number | 总结果数。 |
##|total_page| number | 总页数。|
|request_id |string|请求 ID。 |

示例

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "page_info": {
            "total_number": 2,
            "page": 1,
            "page_size": 10,
            "total_page": 1
        },
        "list": [
            {
                "asset_name": "{{asset_name}}",
                "store_role": null,
                "catalog_role": null,
                "advertiser_role": "ADMIN",
                "tt_account_roles": null,
                "owner_bc_name": "{{owner_bc_name}}",
                "advertiser_account_type": "AUCTION",
                "asset_id": "{{asset_id}}",
                "asset_type": "ADVERTISER"
            },
            {
                "asset_name": "{{asset_name}}",
                "store_role": null,
                "catalog_role": null,
                "advertiser_role": "ADMIN",
                "tt_account_roles": null,
                "owner_bc_name": "{{owner_bc_name}}",
                "advertiser_account_type": "AUCTION",
                "asset_id": "{{asset_id}}",
                "asset_type": "ADVERTISER"
            }
        ]
    }
}
(/code)