获取资产组信息

您可以使用本接口获取商务中心下一个资产组中的资产或成员信息。您必须是商务中心管理员用户。

请求

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

方法 GET

Header

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

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID。|
| asset_group_id {必填}| string | 资产组名ID。|
| query_entity  {必填}| string | 您想要获取的对象。枚举值：`ASSET`，`MEMBER`。|
|filtering | object | 筛选条件。|
#|keyword | string | 筛选关键词。<li>如果`query_entity`为`ASSET`，您可以传入`asset_name`的相关关键词进行模糊搜索，或传入`asset_id`进行精确搜索。<li>如果`query_entity`为`MEMBER`，您可以传入`user_name`的相关关键词进行模糊搜索，或传入`user_email`进行精确搜索。|
|page | number | 当前页数。默认值：1。|
|page_size | number |分页大小。默认值：10。|

返回

|字段|类型|描述|
|---|---|---|
|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_group | object[] | 资产组信息。|
##| asset_group_name  | string | 资产组名称。|
##| asset_group_id | string | 资产组ID。|
##| assets | object[] | 资产信息。当`query_entity`为`ASSET`时返回。|
###| asset_type| string | 资产类型。 |
###| asset_id |string | 资产ID。|
##| members | object[] | 成员信息。当`query_entity`为`ASSET`时返回。|
###| asset_roles| map < string, string > | 您根据资产类型为成员分配的资产角色。 |
###| member_id |string | 成员ID。|
#|page_info|object| 分页信息。|
##|page|number| 当前页数。默认值：1。|
##|page_size| number | 分页大小。默认值：10。|
##|total_number| number | 总结果数。 |
##|total_page| number | 总结果页数。|

示例

(code)
{
    "code": 0,
    "message": "OK",
    "request_id": "20221109082332010251079116030440F4",
    "data": {
        "page_info": {
            "total_page": 1,
            "total_number": 1,
            "page": 1,
            "page_size": 10
        },
        "asset_group": {
            "asset_group_name": "Asset group API test_",
            "asset_group_id": "7161797128677752833",
            "assets": [
                {
                    "asset_type": "ADVERTISER",
                    "asset_id": "7069762178752004097"
                }
            ]
        }
    }
}

{
    "code": 0,
    "message": "OK",
    "request_id": "2022110908240201025107911603044764",
    "data": {
        "asset_group": {
            "members": [
                {
                    "asset_roles": {
                        "ADVERTISER": "ADVERTISER_ROLE_ADMIN"
                    },
                    "member_id": "7020983073270547458"
                }
            ],
            "asset_group_name": "Asset group API test_",
            "asset_group_id": "7161797128677752833"
        },
        "page_info": {
            "total_page": 1,
            "page_size": 10,
            "total_number": 1,
            "page": 1
        }
    }
}
(/code)