← 返回目录
📁 API Reference › GMV Max

检查 TikTok Shop 是否可用于商品 GMV Max 推广系列

您可以使用本接口检查某个 TikTok Shop 是否已在处于启用状态的视频购物广告或商品购物广告中占用,以及是否支持创建推广此 TikTok Shop 中的所有商品的商品 GMV Max 推广系列。

请求

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

方法 GET

Header

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

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
| store_id {必填} | string |  TikTok Shop ID。<br><br> 若想获取可用于 GMV Max 推广系列的 TikTok Shop,可使用 [/gmv_max/store/list/](1822001044479041.html) 并确认返回的 `is_gmv_max_available` 为 `true`。  |

示例

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

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|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| 返回数据。 |
#| promote_all_products_allowed | boolean | 是否支持使用此 TikTok Shop 创建推广此 TikTok Shop 中的所有商品的商品 GMV Max 推广系列。<br> <br>支持的值:`true`,`false`。|
#| is_running_custom_shop_ads | boolean| 此 TikTok Shop 是否已在处于启用状态的视频购物广告或商品购物广告中占用。<br> <br>支持的值:`true`,`false`。|

示例

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

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →