获取 GMV Max 推广系列可用的 TikTok Shop
您可以使用本接口获取某个广告账号有权限访问的 TikTok Shop 列表，以及这些 TikTok Shop 是否可用于创建GMV Max 推广系列。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/gmv_max/store/list/
方法 GET
Header
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
参数
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/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)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| store_list | object[] | 该广告账号有权限访问的 TikTok Shop 列表。|
##| store_id | string | TikTok Shop ID。|
##| is_gmv_max_available | boolean | 该 TikTok Shop 是否可用于 GMV Max 推广系列。 <br><br>支持的值： <ul><li>`true`：可用。</li><li>`false`：不可用。</li></ul>|
##| store_authorized_bc_id | string |有权限访问该 TikTok Shop（`store_id`）的商务中心的 ID。 |
##| is_owner_bc | boolean | 此商务中心（`store_authorized_bc_id`）是否拥有该 TikTok Shop （`store_id` ）。<br><br> 支持的值：<ul><li>`true`：此商务中心拥有该 TikTok Shop。</li><li> `false`：此商务中心是有权限访问该 TikTok Shop 的合作伙伴商务中心，但不拥有该 TikTok Shop。 </li></ul>|
##| store_authorized_bc_info | object |有权限访问该 TikTok Shop 的商务中心的有关信息。 |
###| bc_id | string |商务中心 ID。 |
###| bc_profile_image | string | 商务中心头像图片 URL。 |
###| bc_name | string | 商务中心名称。 |
###| user_role| string | 用户（成员）在商务中心中的角色。<br><br> 枚举值： <ul><li>`ADMIN`：管理员。管理员可以访问商务中心内的所有功能。</li><li>`STANDARD`：标准。标准成员只能对分配给他们的账户进行操作。</li></ul>|
##| thumbnail_url | string | TikTok Shop 缩略图 URL。|
##| store_name | string | TikTok Shop 名称。 |
##| store_code| string | TikTok Shop 的店铺代码。 |
##| targeting_region_codes | string[] | TikTok Shop 可定向的地域的代码。<br><br> 若想查看某一地域代码对应的地域，可查看[附录-地区代码](1737585867307010.html)。<br><br> 例如，`VN` 代表越南。|
##| store_status | string | TikTok Shop 的状态。<br><br> 枚举值：<ul><li>`ACTIVE`：可用。</li><li>`INACTIVE`：不可用。</li><li>`NEW_CREATE`：新建。</li></ul>|
##| store_role | string |商务中心用户对该 TikTok Shop 的权限。<br><br>枚举值：<ul><li>`AD_PROMOTION`：广告推广。创建广告来推广此 TikTok Shop 的商品。</li><li>`MANAGER`：管理员。在 Store Manager 中管理店铺和相关商品库，并查看 Store Manager 中的数据洞察。 </li><li>`UNSET`：未设置。</li></ul>|
##| exclusive_authorized_advertiser_info | object | 有关该 TikTok Shop 的 GMV Max 专属授权信息。|
###| advertiser_id | string |已获得该 TikTok Shop 的专属授权，可使用此店铺创建 GMV Max 推广系列的唯一 广告账户的 ID。 |
###| advertiser_name | string | 已获得该 TikTok Shop 的专属授权，可使用此店铺创建 GMV Max 推广系列的唯 一广告账户的名称。|
###| advertiser_status | string | 已获得该 TikTok Shop 的专属授权，可使用此店铺创建 GMV Max 推广系列的 唯一广告账户的状态。 <br><br>枚举值：<ul><li>`STATUS_ENABLE`：审核通过。</li><li>`STATUS_CONFIRM_FAIL`：未通过审核。</li><li>`STATUS_PENDING_CONFIRM`：正在审核。</li><li>`STATUS_LIMIT`：暂时停用。</li><li>`STATUS_CONTRACT_PENDING`：合同未生效。</li><li>`STATUS_DISABLE`：永久停用。</li><li>`STATUS_PENDING_CONFIRM_MODIFY`：修改待审核。</li><li>`STATUS_PENDING_VERIFIED`待验证。</li><li>`STATUS_SELF_SERVICE_UNAUDITED`：自助开户待验证资质。</li><li> `STATUS_WAIT_FOR_BPM_AUDIT`：CRM 系统待审核。</li><li>`STATUS_CONFIRM_FAIL_END`：CRM 系统未通过审核。 </li><li>`STATUS_CONFIRM_MODIFY_FAIL`：修改未通过审核。 </li></ul>|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"store_list": [
{
"exclusive_authorized_advertiser_info": {
"advertiser_id": "{{advertiser_id}}",
"advertiser_name": "{{advertiser_name}}",
"advertiser_status": "STATUS_ENABLE"
},
"is_gmv_max_available": false,
"is_owner_bc": true,
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_authorized_bc_info": {
"bc_id": "{{bc_id}}",
"bc_name": "{{bc_name}}",
"bc_profile_image": "{{bc_profile_image}}",
"user_role": "ADMIN"
},
"store_code": "{{store_code}}",
"store_id": "{{store_id}}",
"store_name": "{{store_name}}",
"store_role": "AD_PROMOTION",
"store_status": "ACTIVE",
"targeting_region_codes": [
"ID"
],
"thumbnail_url": "{{thumbnail_url}}"
},
{
"exclusive_authorized_advertiser_info": {
"advertiser_id": "{{advertiser_id}}",
"advertiser_name": "{{advertiser_name}}",
"advertiser_status": "STATUS_ENABLE"
},
"is_gmv_max_available": true,
"is_owner_bc": true,
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_authorized_bc_info": {
"bc_id": "{{bc_id}}",
"bc_name": "{{bc_name}}",
"bc_profile_image": "{{bc_profile_image}}",
"user_role": "ADMIN"
},
"store_code": "{{store_code}}",
"store_id": "{{store_id}}",
"store_name": "{{store_name}}",
"store_role": "AD_PROMOTION",
"store_status": "ACTIVE",
"targeting_region_codes": [
"ID"
],
"thumbnail_url": "{{thumbnail_url}}"
},
{
"exclusive_authorized_advertiser_info": {
"advertiser_id": "{{advertiser_id}}",
"advertiser_name": "{{advertiser_name}}",
"advertiser_status": "STATUS_ENABLE"
},
"is_gmv_max_available": true,
"is_owner_bc": false,
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_authorized_bc_info": {
"bc_id": "{{bc_id}}",
"bc_name": "{{bc_name}}",
"bc_profile_image": "{{bc_profile_image}}",
"user_role": "ADMIN"
},
"store_code": "{{store_code}}",
"store_id": "{{store_id}}",
"store_name": "{{store_name}}",
"store_role": "AD_PROMOTION",
"store_status": "ACTIVE",
"targeting_region_codes": [
"MY"
],
"thumbnail_url": "{{thumbnail_url}}"
},
{
"exclusive_authorized_advertiser_info": {
"advertiser_id": "{{advertiser_id}}",
"advertiser_name": "{{advertiser_name}}",
"advertiser_status": "STATUS_ENABLE"
},
"is_gmv_max_available": false,
"is_owner_bc": false,
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_authorized_bc_info": {
"bc_id": "{{bc_id}}",
"bc_name": "{{bc_name}}",
"bc_profile_image": "{{bc_profile_image}}",
"user_role": "ADMIN"
},
"store_code": "{{store_code}}",
"store_id": "{{store_id}}",
"store_name": "{{store_name}}",
"store_role": "AD_PROMOTION",
"store_status": "ACTIVE",
"targeting_region_codes": [
"ID"
],
"thumbnail_url": "{{thumbnail_url}}"
}
]
}
}
(/code)