获取资产组列表

您可以使用本接口获取商务中心下的资产组列表。您必须是商务中心管理员用户。

请求

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

方法 GET

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |
|Content-Type  {必填}|string|请求消息类型。<br>允许值：`"application/json"`。 |

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID。|
|filtering | object | 筛选条件。|
#|keyword | string | 筛选关键词。目前您只能通过指定`asset_group_name`或`asset_group_id`进行精确搜索。|
|page | number | 当前页数。默认值：1。|
|page_size | number |分页大小。默认值：10。|

示例

(code curl http)
curl --location --request GET https://business-api.tiktok.com/open_api/v1.3/catalog/overview/?bc_id={{bc_id}}&catalog_id={{catalog_id}}
--header 'Access-Token: {{Access-Token}}'
--header 'Content-Type: application/json'
(/code)

返回

|字段|类型|描述|
|---|---|---|
|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|返回数据。  |
#| asset_groups | object[] | 资产组信息。|
##| asset_group_id | string | 资产组名ID。|
##| asset_group_name  | string | 资产组名称。|
#|page_info|object| 分页信息。|
##|page|number| 当前页数。默认值：1。|
##|page_size| number | 分页大小。默认值：10。|
##|total_number| number | 总结果数。 |
##|total_page| number | 总结果页数。|

示例

(code)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "2022110908243201025107911603044DD2",
    "data": {
        "page_info": {
            "total_page": 1,
            "page_size": 10,
            "total_number": 1,
            "page": 1
        },
        "asset_groups": [
            {
                "asset_group_id": "7161375800388747266",
                "asset_group_name": "测试asset group5"
            }
        ]
    }
}
(/code)