一、上传视频接口 v2（推荐使用）
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/file/ad/video/upload
请求方式：POST
数据格式：FORM
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主ID |
在获取access_token的时候返回 |
file |
file |
必填 |
视频文件 |
只支持mp4格式，详细要求见附录 |
type |
int |
可选 |
上传视频类型 |
1：信息流广告竖版视频（默认） 2：信息流横版视频 3：后贴片竖版视频（已下线） 4：后贴片横版视频（已下线） 5：联盟图片素材 |
signature |
string |
必填 |
视频md5值 |
用于服务端校验 |
sync |
int |
选填 |
用同步/异步方式上传视频 |
0：（默认）当值为0，以异步方式上传，不需要同步等待，上传较快 1：当值为1，同步方式上传，上传较慢 |
photo_name |
string |
非必填 |
视频名称，默认是视频 id |
不超过 50 字符 |
photo_tag |
string[] |
非必填 |
视频标签 |
单个标签不超过 10 字符，支持一个标签 |
返回参数 |
|||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
struct |
JSON返回值 |
|
photo_id |
string |
视频ID |
|
photoId |
string |
视频ID（废弃） |
|
signature |
string |
视频md5值 |
请求样例 |
curl -X POST \ -H 'Access-Token: 69d99a7c1fdf3f4b271b' \ -H 'Content-Type: multipart/form-data' \ -F "advertiser_id=20000152" \
-F "file=@/Users/jackchou/Downloads/ad-material/111602-补水仪01.mp4" \ -F "signature=f9bdb92dee8dadc381c4fd7831089d0e" \ -L https://ad.e.kuaishou.com/rest/openapi/v2/file/ad/video/upload |
返回样例 |
{ "code":0, "message":"OK", "data":{ "photo_id":"5227271804177341686", "photoId":"5227271804177341686", "signature":"f9bdb92dee8dadc381c4fd7831089d0e" } } |
二、 获取视频信息接口 v2（推荐使用，可查uid下所有非素造视频）
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/list
请求方式：POST
数据格式：JSON
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主ID |
在获取accessToken的时候返回 |
photo_ids |
string[] |
非必填 |
视频 id列表， |
不超过 100 个 id |
new_status |
int |
非必填 |
视频状态s |
0：删除， -1：全部数据，包含删除 不传默认返回不含删除的数据 |
end_date |
string |
可选 |
结束时间 |
与start_date同时传或同时不传； 过滤筛选条件，格式为"yyyy-MM-dd" |
page |
int |
可选 |
查询的页码数 |
默认为1 |
page_size |
int |
可选 |
单页行数 |
默认为20，不超过200 |
返回参数 |
|||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
struct |
JSON返回值 |
|
details |
struct |
||
photo_id |
string |
视频ID |
|
width |
int |
视频宽度 |
|
height |
int |
视频高度 |
|
url |
string |
视频预览链接 |
|
cover_url |
string |
视频首帧图片链接 |
|
signature |
string |
视频md5值 |
|
total_count |
int |
视频总数 |
|
status |
string |
视频状态 |
0：有效 1：已从客户端删除 |
upload_time |
string |
上传时间 |
|
photo_name |
string |
视频名称 |
默认是视频 id |
photo_tag |
string[] |
视频标签 |
|
new_status |
int |
视频状态 |
0：逻辑删除，1：正常 |
duration |
long |
视频时长 |
单位毫秒 |
source |
int |
视频来源 |
0：自上传，1：开眼，2：素造，7：聚星视频 |
请求样例 |
curl -X GET \ -H 'Access-Token: 6acd879e43a39dfbd9e757e2082b58b5' \ -H 'Content-Type: application/json' \ -d '{ "advertiser_id": 200152 }' -L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/list |
返回样例 |
{ "code": 0, "message": "OK", "data": { "total_count": 44, "details": [ { "width": 720, "height": 1280, "url": "http://hwmov.a.yximgs.com/upA5MjMxMDQ05MF8wXzM=_b_Be957badfd1d7fe45db3d066d4f67a1a8.mp4?tag=1-156920690d86659d5ca", "signature": "f9bdb92dee8dadc381c4fd7831089d0e", "photo_id": "5246693584821825030", "cover_url": "http://hw.a.yximgs.com/upiMV8xNzc2NzExNzY5MF8wXzM=_B9b9f47dc0c9e89a14142c6c8a0e90171.jpg?tag=1-15692064c46fbbc0fe" }, { "width": 720, "height": 1280, "url": "http://jsmov2.a.yximgs.com/upic/201BMjAxOTA5Maf5a45ed3fc3c1.mp4?tag=1-156923a3bf18c8", "signature": null, "photo_id": "5199124315305004489", "cover_url": "http://js2.a.yximgs.com/upic/20OTA59a4a03ed6f895b3f2e796bf.jpg?tag=1-15692060d09bd284" } ] } } |
