1、获取投放资质
GET/POST /rest/openapi/v1/agent/advertiser/delivery_cert/get
请求参数
字段 |
类型 |
说明 |
是否必填 |
备注 |
agent_id |
long |
快手广告代理商id |
是 |
必填，和access_token一致 |
advertiser_id |
long |
广告主id |
是 |
返回参数
只返回投放资质（cert_category为5）
字段 |
类型 |
说明 |
备注 |
common_cert_list |
AdBpCommonCert[] |
当前投放资质列表 |
只返回cert_category为5的资质 |
2、上传资质文件
POST /rest/openapi/v1/agent/file/upload
请求参数
字段 |
类型 |
说明 |
是否必填 |
备注 |
file |
MultipartFile |
要上传的资质文件 |
是 |
支持jpg、jpeg、pdf、gif格式，小于5MB |
agent_id |
long |
快手广告代理商 id |
是 |
返回参数
创建或更新资质(接口9或接口10）时传入file_token字段
字段 |
类型 |
说明 |
备注 |
file_token |
string |
资质文件标识 |
|
url |
string |
文件预览链接 |
3、发送验证码
POST /rest/openapi/v1/agent/sms_code/send
请求参数
字段 |
类型 |
说明 |
是否必填 |
备注 |
agent_id |
long |
快手推广代理商id |
是 |
和access_token一致，对应的代理商必须存在，不能是不合作的快手推广代理商 |
advertiser_user_id |
long |
快手广告主userId |
是 |
被创建账号的userId，对应的用户必须存在，没有余额，没有被封禁，不能是快手代理商 |
返回参数
发送验证码短信到注册advertiser_user_id对应的手机上
字段 |
类型 |
说明 |
备注 |
result |
boolean |
是否成功 |
快手信息流广告投放代理商 |
4、创建账户
POST /rest/openapi/v1/agent/advertiser/create
请求参数
字段 |
类型 |
说明
|
是否必填 |
备注 |
agent_id |
long |
快手广告代理商id |
是 |
和access_token一致 |
advertiser_user_id |
long |
快手广告主userId |
是 |
被创建账号的userId |
corporation_name |
string |
公司名称 |
是 |
被创建账号的公司名 |
sms_code |
string |
验证码 |
是 |
和收到的短信验证码一致 |
返回参数
字段 |
类型 |
说明 |
备注 |
id |
long |
广告主id |
被创建账号的id |
5、创建或更新快手推广账户信息和开户资质
POST /rest/openapi/v1/agent/advertiser/cert/submit
请求参数
接口9只能修改账户信息和开户资质（cert_category包括1，2，3，4)
字段 |
类型 |
说明 |
是否必填 |
备注 |
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个字符 |
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-行业资质） 不同的资质按照类型分为必填和选填 |
CertParam
字段 |
类型 |
说明 |
备注 |
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 |
是否成功 |
6、创建或更新投放资质
POST /rest/openapi/v1/agent/advertiser/delivery_cert/submit
请求参数
只能在提交快手开户资质（接口9）后提交投放资质
字段 |
类型 |
说明 |
是否必填 |
备注 |
advertiser_id |
long |
广告主id |
是 |
|
agent_id |
long |
代理商id |
是 |
和access_token保持一致 |
cert_list |
CertParam[] |
投放资质列表 |
否 |
只传投放资质（cert_category为5) 如果不填，代表删除所有投放资质 |
返回参数
接口10只能修改投放资质(cert_category是5）
字段 |
类型 |
说明 |
备注 |
result |
boolean |
是否成功 |
河北定州快手视频的广告开户找哪家代理商比较靠谱？河北任丘快手怎么放广告,任丘快手上游戏广告怎么上线的？河北三河如何在快手上放广告？三河快手营销广告开户价格,山西快手推广开户代理商/山西快手短视频广告开户平台！快手全国推广开户电话：4009602809
