新增广告主
新增广告主接口
请求地址
https://openapi.aiclk.com/openapi/v1/adaccount/customer/create
所属权限
ads_write
请求方式
POST
请求参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 代理商/子管理ID |
Post body(json)
json体是一个列表结构,列表中的每一个元素结构如下:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| sub_agent_id | uint64 | 否 | 子代理ID,调用者账号为代理商时可填 |
| company | string | 是 | 广告主公司名称 |
| display_name | string | 是 | 广告主公司简称 |
| license_code | string | 是 | 营业执照统一社会信用代码 |
| company_region | []uint64 | 是 | 公司地址省市区编码,枚举值 |
| company_address | string | 是 | 公司地址 |
| license | uint64 | 是 | 营业执照资源id,资源上传接口文档 |
| qualification | []uint64 | 是 | 资质证明资源id,资源上传接口文档 |
| category | int32 | 是 | 归属行业,对应最小粒度分类的ID,枚举值 |
| app_name | string | 是 | 推广产品 |
| username | string | 是 | 账户名称 |
| password | string | 是 | 账户密码,必须包含大小写字母和数字,6到30位 |
| link | string | 是 | 开户链接 |
| source_mark | string | 是 | 广告主来源标识 |
| app_company | string | 否 | 软著著作权人,当行业为应用下载时必填 |
| privacy_protocol_url | string | 否 | 隐私政策协议,当行业为应用下载时必填 |
| app_info | string | 否 | 应用介绍,当行业为应用下载时必填 |
| app_permission | string | 否 | 应用权限,当行业为应用下载时必填 |
| string | 是 | 公司邮箱 | |
| contacter | string | 是 | 联系人姓名 |
| contacter_phone | string | 是 | 联系人电话 |
| contacter_email | string | 否 | 联系人邮箱 |
Body 示例
{
"sub_agent_id":1716318,
"company": "测试公司",
"display_name": "测试公司简称",
"license_code": "DSSSAAASSSSWSSSSDA",
"company_address":"上海上海市浦东新区三林软件园1号楼",
"company_region":[310000,310100,310115],
"license": 14705564,
"qualification": [
14705564
],
"category": 100101101,
"app_name": "测试产品名称",
"username": "ceshizhanghumingcheng6",
"password": "******",
"link": "https://apps.apple.com/cn/app/affinity-photo-2-image-editor/id1616822987?mt=12",
"source_mark": "来源标识",
"app_company": "著作权人",
"privacy_protocol_url": "https://quda.qutoutiao.net/pub/prd/aByL.html?t=1603353547893",
"app_info": "应用介绍",
"app_permission": "应用权限",
"crowd_consumption_preference": 0,
"email": "ceshiyouxiang@admin.com",
"contacter": "联系人姓名",
"contacter_phone": "17600000001",
"contacter_email": "lianxiren@admin.com"
}
请求示例
curl --location 'https://openapi.aiclk.com/openapi/v1/adaccount/customer/create?account_id=1000003' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data-raw '{
"sub_agent_id":1716318,
"company": "测试公司",
"display_name": "测试公司简称",
"license_code": "DSSSAAASSSSWSSSSDA",
"company_address":"上海上海市浦东新区三林软件园8号楼2楼",
"company_region":[310000,310100,310115],
"license": 14705564,
"qualification": [
14705564
],
"category": 100101101,
"app_name": "测试产品名称",
"username": "ceshizhanghumingcheng7",
"password": "Abc123",
"link": "https://apps.apple.com/cn/app/affinity-photo-2-image-editor/id1616822987?mt=12",
"source_mark": "来源标识",
"app_company": "著作权人",
"privacy_protocol_url": "https://quda.qutoutiao.net/pub/prd/aByL.html?t=1603353547893",
"app_info": "应用介绍",
"app_permission": "应用权限",
"crowd_consumption_preference": 0,
"email": "ceshiyouxiang@admin.com",
"contacter": "联系人姓名",
"contacter_phone": "17600000001",
"contacter_email": "lianxiren@admin.com"
}'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 接口信息 |
| data | object | 返回值 |
| - account_id | int | 广告主ID |
| trace_id | string | trace ID |
返回示例
{
"code": 200,
"data": {
"account_id": 1928316
},
"message": "success",
"trace_id": "56161c89ed743bff"
}