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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手推广主ID

在获取access_token的时候返回

file

file

必填

视频文件

只支持mp4格式，详细要求见附录

type

int

可选

上传视频类型

0：发现页信息流视频，默认值

1：信息流竖版视频

2：信息流横版视频

3：后贴片竖版视频（已下线）

4：后贴片横版视频（已下线）

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

photo_id

string

视频ID

请求样例

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" \

-L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/upload

返回样例

{

  "code":0,

  "message":"OK",

  "data":{

       "photo_id":"5227271804177341686"

  }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告推广主ID

在获取accessToken的时候返回

photo_ids

string[]

必填

视频ID集

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

photo_id

string

视频ID

width

int

视频宽度

height

int

视频高度

url

string

视频预览链接

cover_url

string

视频首帧图片链接

signature

string

视频md5值

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,

            "photo_ids":["52272711686"]

}' -L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/get

返回样例

{

   "code": 0,

   "message": "OK",

   "data": [

       {

       "width": 720,

       "height": 1280,

           "url": "http://ydmov.a.yximgs.com/upic/2019/07/02/14/BMjAxOTNDEwNDBfMTIxMTYxMDcxMV88wXzM=_b_B66666912a9307.mp4?tag=1-15620569-765dff6842b4",

       "photo_id": "51923688",

       "cover_url": "http://yd.a.yximgs.com/upic/2019/07/02/14/BMjAxOTBfMTIxMTYxMDcxMV8xNDM18wXzM=_B0fcc425.jpg?tag=1-1562056772-unknown-0-5x0jhyn-0a89d56"

       }

   ]

}