字段

类型

是否必填

说明

备注

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 字符，支持一个标签

字段

类型

是否必填

说明

备注

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：聚星视频