获取广告账户下可用的商店

您可以使用本接口获取广告账户下可用的第一方商店（TikTok Shop）列表。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/store/list/

方法 GET

header

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

参数

|字段{25%}|类型{15%}|描述{60%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。|
| store_id | string | 您想筛选的第一方商店（TikTok Shop）的商店ID。 若未传入本字段，则将返回指定的广告账户下所有的可用`store_id`信息。<br><p><span style="color:darkred"><b>注意</b></span>：欲获取 TikTok Shop 的商店 ID，您可以调用[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401)：<ul><li>当返回中的`asset_type` 为 `TIKTOK_SHOP`时，对应的`asset_id`为TikTok Shop 的商店 ID。</li></ul> |
| store_type | string |您想筛选的商店类型。<br>枚举值：`TIKTOK_SHOP` （TikTok Shop）。<br> 若未传入本字段，则将会返回广告账户下所有商店的结果。|

示例

(code curl http)
curl --location --request GET 'https://business-api/open_api/v1.3/store/list/?advertiser_id={{advertiser_id}}' \
--header 'Access-Token: {{Access-Token}}' \
(/code)

| 字段 {35%}|类型{15%} | 描述{50%} |
|---|---|---|
|code |number | 返回码。完整返回码列表及描述，可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string | 返回信息。更多信息可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object| 返回数据。 |
#| stores | object[] |广告账户下可用商店的信息。 |
##| store_authorized_bc_id | string |已经授权可管理该商店（`store_id`）的商务中心的ID。 经授权后多个商务中心可管理同一商店。|
##| store_id | string |TikTok Shop 的商店 ID。请查看[创建商品来源为TikTok Shopping的视频购物广告-创建广告组]( https://ads.tiktok.com/marketing_api/docs?id=1750361719059457)，了解如何将`store_id`用于创建购物广告。|
##| store_type | string | 商店类型。枚举值：`TIKTOK_SHOP` （TikTok Shop）。|
##| store_name | string |商店名称。 |
##| store_code | string |仅当商店的`store_type`为`TIKTOK_SHOP`时返回。<br><br>第一方商店（TikTok Shop）的商店代码。 |
##| catalog_id {-即将废弃}| string |与该商店绑定的商品库的ID。一个商品库仅可与一个商店绑定。|
##| targeting_region_codes | string[] |商店可用于定向的地域代码。请查看[附录-地区代码]( https://ads.tiktok.com/marketing_api/docs?id=1737585867307010)了解代码代表的具体地域。|
| request_id | string |请求的日志 ID，唯一标识一个请求。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "stores": [
            {
                "tiktok_account_binding_status": null,
                "store_id": "{{store_id}}",
                "store_type": "TIKTOK_SHOP",
                "catalog_id": "{{catalog_id}}",
                "store_authorized_bc_id": "{{store_authorized_bc_id}}",
                "store_name": "{{store_name}}",
                "store_code": "{{store_code}}",
                "targeting_region_codes": [
                    "ID"
                ]
            }
        ]
    }
} 
(/code)