创建资产组

您可以使用本接口在商务中心下创建一个资产组。您必须是商务中心管理员用户。

请求

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

方法 POST

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_name  {必填} | string | 资产组名称。 |
| assets {必填} | object[] | 您想要添加到资产组的资产。最多可传入200个资产ID。 |
#| asset_id {必填}  | string| 资产ID。当资产类型（`asset_type`）为`ADVERTISER`时，该字段为广告主账号ID。|
#| asset_type| string | 资产类型。目前仅支持`ADVERTISER`类型的资产。系统将默认使用`ADVERTISER`，因此您无需传入本字段。|
| members {必填} | object[] |您希望添加到资产组的商务中心成员。最多可传入50个ID。|
#| member_id {必填}  | string| 成员ID。  |
#| asset_roles | map < string, string>| 您根据资产类型为成员分配的资产角色。<br>键：资产类型。枚举值：`ADVERTISER`。<br>值：分配的角色。枚举值：<ul><li>`ADVERTISER_ROLE_ADMIN`（广告账户管理员）：<br>管理广告账户：管理广告账户的设置、资金、权限。<br>管理推广系列：创建、编辑广告。<br>获取广告表现：获取广告报表，查看广告。</li><li>`ADVERTISER_ROLE_OPERATOR`（广告账户操作员）：<br>管理推广系列：创建、编辑广告。<br>获取广告表现：获取报表，查看广告。</li><li>`ADVERTISER_ROLE_ANALYST`（广告账户分析师）：<br>获取广告表现：获取报表，查看广告。</li></ul>默认值：`&#123;"ADVERTISER":"ADVERTISER_ROLE_ADMIN"&#125;`。

示例

(code)
curl --location --request POST https://business-api.tiktok.com/open_api/v1.3/bc/asset_group/create/
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bc_id": "{{bc_id}}",
    "asset_group_name": "{{asset_group_name}}",
    "assets": [
        {
            "asset_id": "{{asset_id_1}}"
        },
        {
            "asset_id": "{{asset_id_2}}"
        }
    ],
    "members": [
        {
            "member_id": "{{member_id}}",
            "asset_roles": "{{asset_roles}}"
        }
    ]
}'
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。  |
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。  |
|data |object|返回数据。  |
#|asset_group_id|string|您创建的资产组的ID。|
|request_id |string|请求的日志ID，唯一标识一个请求。  |

示例

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