快手广告代理商接口《NO.2》

字段

类型

说明

是否必填

备注

agent_id

long

快手广告代理商id

是

必填，和access_token一致

advertiser_id

long

广告主id

是

字段

类型

说明

备注

common_cert_list

AdBpCommonCert[]

当前投放资质列表

只返回cert_category为5的资质

字段

类型

说明

是否必填

备注

file

MultipartFile

要上传的资质文件

是

支持jpg、jpeg、pdf、gif格式，小于5MB

agent_id

long

快手广告代理商 id

是

字段

类型

说明

备注

file_token

string

资质文件标识

url

string

文件预览链接

字段

类型

说明

是否必填

备注

agent_id

long

快手推广代理商id

是

和access_token一致，对应的代理商必须存在，不能是不合作的快手推广代理商

advertiser_user_id

long

快手广告主userId

是

被创建账号的userId，对应的用户必须存在，没有余额，没有被封禁，不能是快手代理商

字段

类型

说明

备注

result

boolean

是否成功

字段

类型

说明

是否必填

备注

agent_id

long

快手广告代理商id

是

和access_token一致

advertiser_user_id

long

快手广告主userId

是

被创建账号的userId

corporation_name

string

公司名称

是

被创建账号的公司名

sms_code

string

验证码

是

和收到的短信验证码一致

字段

类型

说明

备注

id

long

广告主id

被创建账号的id

字段

类型

说明

是否必填

备注

advertiser_id

long

快手广告主id

是

agent_id

long

代理商id

是

industry_id

long

二级行业id

是

传入接口3返回的行业列表中的二级行业id

corporation_name

string

公司名称

是

不能超过50个字符

web_site

string

公司网站

是

http://或https://开头，可以访问的网站

contact_name

string

联系人姓名

是

中文或英文，不能超过50个字符

email

string

邮箱

是

xxx@

phone

string

手机号码

是

不加区号，11位

product_name

string

产品名/品牌名

是

可以传入接口2返回的产品列表中的产品，也可以传入新的

marketing_content_type

int

推广内容类型

是

1-推广内容链接，2-推广应用

licence_id

string

营业执照编号

是

只能有数字和字母

licence_location

string

营业执照注册地

是

传入接口1返回的注册地列表的地区，格式是"xx省-xx市"

cert_list

CertParam[]

开户资质列表

是

只传开户资质（cert_category包括1-营业执照，2-ICP备案，3-投放承诺函，4-行业资质）

不同的资质按照类型分为必填和选填

字段

类型

说明

备注

cert_id

long

资质id

新增时传0，非0的只能是已有资质的id

cert_category

int

资质类型

1-营业执照，必填，传1个文件，需要有效期

2-ICP备案，选填，传1个文件，永久有效，不需要有效期，expire_time可以不传或传任意值

3-投放承诺函，必填，最多10个文件，需要有效期

4行业资质，选填，最多50个文件，需要有效期

5-投放资质，选填，最多50个文件，永久有效，不需要有效期, expire_time可以不传或传任意值

接口9只能涉及开户资质1、2、3、4

接口10可以涉及全部资质1、2、3、4、5，但5只能在开户后提交

file_token

string

资质文件标识

传入接口6返回的file_token字段

expire_time

string

资质有效期

时间格式如 yyyy-MM-dd，空字符串表示长期有效

字段

类型

说明

备注

result

boolean

是否成功

字段

类型

说明

是否必填

备注

advertiser_id

long

广告主id

是

agent_id

long

代理商id

是

和access_token保持一致

cert_list

CertParam[]

投放资质列表

否

只传投放资质（cert_category为5)

如果不填，代表删除所有投放资质

字段

类型

说明

备注

result

boolean

是否成功