在商务中心获取与 TikTok 账号关联的广告账号

此接口可用于在商务中心获取与 TikTok 账号关联的广告账号列表。

广告账号与 TikTok 账号在商务中心关联后，有权访问该广告账号的商务中心成员即可在其中使用该 TikTok 账号投放广告。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/bc/asset/advertiser/assigned/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br><br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|bc_id {必填}|string|商务中心 ID。<br><br>若想获取你有权访问的商务中心列表，请使用 [/bc/get/](1737115687501826.html) 接口。|
|asset_id {必填}|string|商务中心内的 TikTok 账号 ID。<br><br>若需获取商务中心内的 TikTok 账号列表，请使用 [/bc/asset/get/](1739432717798401.html) 接口并将 `asset_type` 设置为 `TT_ACCOUNT` 或 `MANAGED_BUSINESS_ACCOUNT`。|
|asset_type {必填}|string|资产类型。<br><br>枚举值：<ul><li>`TT_ACCOUNT`：用于投放广告的 TikTok 账号。你可以使用这些 TikTok 账号投放广告。</li><li>`MANAGED_BUSINESS_ACCOUNT`：用于管理企业号的 TikTok 账号。你可以使用这些 TikTok 账号投放广告，并在你的 TikTok 账号中管理消息、线索、表单、评论、商品链接和洞察。</li></ul>|
|page|number|当前页码。<br><br>值范围：≥1。<br>默认值：1。|
|page_size|number|页面大小。<br><br>值范围：1-50。<br>默认值：10。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/bc/asset/advertiser/assigned/?bc_id={{bc_id}}&asset_type=TT_ACCOUNT&asset_id={{asset_id}}&page=1&page_size=50' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code|number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|list|object[]|商务中心内与 TikTok 账号 (`asset_id`) 关联的广告账号列表。|
##|advertiser_id|string|广告账号 ID。|
##|advertiser_name|string|广告账号的名称。|
#|page_info|object|分页信息。|
##|page|number|当前页码。|
##|page_size|number|页面大小。|
##|total_number|number|结果总数。|
##|total_page|number|结果总页数。|

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "list": [
            {
                "advertiser_id": "{{advertiser_id}}",
                "advertiser_name": "{{advertiser_name}}"
            },
            {
                "advertiser_id": "{{advertiser_id}}",
                "advertiser_name": "{{advertiser_name}}"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 50,
            "total_number": 2,
            "total_page": 1
        }
    }
}
(/code)