删除广告主

删除代理商或子代理名下的广告主账户。

请求地址

https://openapi.aiclk.com/openapi/v1/adaccount/customer/delete

所属权限

ads_write

请求方式

POST

请求参数

字段名	类型	是否必须	描述
account_id	int	是	当前授权的代理商或子代理 ID

Post body（json）

字段名	类型	是否必须	描述
account_ids	uint64[]	是	要删除的广告主 ID，最多 100 个，不能为 0 或重复

删除前需要有权操作该广告主，广告主不能已删除，现金余额和优惠券余额必须为 0。删除成功后广告主进入回收站，历史数据和流水保留。每个广告主的处理结果在 data.items 中返回。

Body 示例

{
  "account_ids": [1000001, 1000002]
}

请求示例

curl --location 'https://openapi.aiclk.com/openapi/v1/adaccount/customer/delete?account_id=1000003' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data '{"account_ids":[1000001,1000002]}'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	json	返回值
- items	array	每个广告主的处理结果
-- account_id	int	广告主 ID
-- status	string	DELETED 删除成功，FAILED 删除失败
-- recycle_id	int	回收站记录 ID，成功时返回
-- error_code	string	失败原因编码
-- message	string	单项处理信息
trace_id	string	trace ID

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "account_id": 1000001,
        "status": "DELETED",
        "recycle_id": 90001,
        "message": "操作成功"
      },
      {
        "account_id": 1000002,
        "status": "FAILED",
        "error_code": "ACCOUNT_BALANCE_NOT_EMPTY",
        "message": "所选广告主账户中仍有可用余额，请处理后重试"
      }
    ]
  },
  "trace_id": "56161c89ed743bff"
}