获取广告账号内的 TikTok Mini 列表

此接口可用于获取广告账号内的 TikTok Mini 列表。

查看创建升级版 Smart+ TikTok Growth Max 小游戏推广系列和创建升级版 Smart+ TikTok Growth Max 短剧推广系列文档，详细了解可推广 TikTok Mini 的推广系列类型。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/minis/get/

方法 GET

Header

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

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|advertiser_id {必填}|string|广告主 ID。|
|page|number|当前页码。<br><br>默认值：1。值范围：≥ 1。|
|page_size|number|页面大小。<br><br>默认值：10。值范围：1-50。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/minis/get/?advertiser_id={{advertiser_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 Mini 列表。|
##|minis_id|string|TikTok Mini 的 ID。|
##|minis_name|string|TikTok Mini 的名称。|
##|minis_icon_url|string|TikTok Mini 的应用头像图片 URL。|
##|minis_status|string|TikTok Mini 的状态。<br><br>枚举值：<ul><li>`ACTIVE`：已激活。可使用 TikTok Mini 创建广告。</li><li>`INACTIVE`：未激活。无法使用 TikTok Mini 创建广告。</li></ul>|
##|minis_type|string|TikTok Mini 的类型。<br><br>枚举值：<ul><li>`MINI_SERIES`：短剧。</li><li>`MINI_GAME`：小游戏。</li></ul>|
##|region_codes|string[]|支持 TikTok Mini 的国家或地区的代码。<br><br>示例：`["ID", "US"]`。|
#|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": [
            {
                "minis_icon_url": "{{minis_icon_url}}",
                "minis_id": "{{minis_id}}",
                "minis_name": "{{minis_name}}",
                "minis_status": "ACTIVE",
                "minis_type": "MINI_GAME",
                "region_codes": [
                    "JP",
                    "US",
                    "ID"
                ]
            },
            {
                "minis_icon_url": "{{minis_icon_url}}",
                "minis_id": "{{minis_id}}",
                "minis_name": "{{minis_name}}",
                "minis_status": "ACTIVE",
                "minis_type": "MINI_GAME",
                "region_codes": [
                    "JP",
                    "US",
                    "ID"
                ]
            },
            {
                "minis_icon_url": "{{minis_icon_url}}",
                "minis_id": "{{minis_id}}",
                "minis_name": "{{minis_name}}",
                "minis_status": "ACTIVE",
                "minis_type": "MINI_SERIES",
                "region_codes": [
                    "JP"
                ]
            },
            {
                "minis_icon_url": "{{minis_icon_url}}",
                "minis_id": "{{minis_id_4}}",
                "minis_name": "{{minis_name_4}}",
                "minis_status": "ACTIVE",
                "minis_type": "MINI_SERIES",
                "region_codes": [
                    "US"
                ]
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 50,
            "total_number": 4,
            "total_page": 1
        }
    }
}
(/code)