更新资产组
您可以使用本接口更新一个资产组下的资产、成员或名称。您必须是商务中心管理员用户。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/bc/asset_group/update/
方法 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_id{必填}|string|您想要更新的资产组的ID。|
|update_entity {必填} | string |您想要更新的对象。枚举值:`ASSET`,`MEMBER`,`NAME`。|
| asset_group_name {+条件必填} | string | 资产组名称。当`update_entity`为`NAME`时必填。 |
| action {+条件必填} | string |进行的操作。枚举值: `ADD`, `DELETE`。当`update_entity`为`MEMBER`时必填。|
| assets {+条件必填} | object[] | 资产。最多可传入200个ID。当`update_entity`为`ASSET`时必填。|
#| asset_id | string| 资产ID。当资产类型(`asset_type`)为`ADVERTISER`时,该字段为广告主账号ID。
#| asset_type| string |资产类型。目前仅支持`ADVERTISER`类型的资产。系统将默认使用`ADVERTISER`,因此您无需传入本字段。 |
| members {+条件必填} | object[] |商务中心下的成员。最多可传入50个ID。当`update_entity`为`MEMBER`时必填。|
#| 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>默认值:`"ADVERTISER: ADVERTISER_ROLE_ADMIN"`。
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|data |object|返回数据。 |
|request_id |string|请求的日志ID,唯一标识一个请求。 |