快手广告管理平台Marketing API开发文档《NO.16》

请求参数

字段

类型

是否必填

说明

备注

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"

  }

}

请求参数

字段

类型

是否必填

说明

备注

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"

           }

       ]

   }

}