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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取accessToken的时候返回

photo_ids

string[]

可选

视频ID集

过滤筛选条件

photo_ids与start_date&end_date只能有一个生效，指定photo_ids时以photo_ids为准

start_date

string

可选

开始时间

与end_date同时传或同时不传；以下两种筛选条件兼容

过滤筛选条件，格式为"yyyy-MM-dd"

过滤筛选条件，格式为 “yyyy-MM-dd HH:mm:ss”

end_date

string

可选

结束时间

与start_date同时传或同时不传；以下两种筛选条件兼容

过滤筛选条件，格式为"yyyy-MM-dd"

过滤筛选条件，格式为 “yyyy-MM-dd HH:mm:ss”

page

int

可选

查询的页码数

默认为1

page_size

int

可选

单页行数

默认为20，不超过200

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

details

struct

JSON返回值

total_count

int

数据的总行数

data

width

int

视频宽度

height

int

视频高度

watermark_url

string

视频预览链接

md5

string

视频md5值

photo_id

string

视频ID

material_id

string

素造视频素材ID

cover_url

string

视频首帧图片链接

sync_date

string

视频同步日期

photo的被创建日期

格式: yyyy-MM-dd HH:mm:ss

covers

struct[]

包括多封面url和预审核状态

见下表

material_tag

string

素造素材标签

firstLevel：

1 电商

2 游戏

3 网服

4 本地

5 金融

secondLevel：

1 综合平台类

2 垂直电商

3 二类电商

4 传统IP/经典成熟

5 休闲游戏

6 主流经济

7 工具类

8 社交类

9 阅读类

10 贷款平台

11 保险

12 信用卡

13 本地

material_title

string

素造素材标题

covers

字段

类型

说明

备注

cover_url

string

封面 url

status

int

审核状态

0：预审通过，

1：预审失败，

2：非预审核

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主 id

photo_ids

string[]

必填

视频 ids，

不超过 10 个

share_advertiser_ids

long[]

必填

推送账户

同一资质下其他 user_id 下的广告主 ids，不超过10个，同一个快手 user_id 下视频是共享的（无需推送），

视频共享只能是同一个资质主体下不同的 user_id 的广告主可以共享

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主 id

photo_ids

string[]

必填

视频 ids，

不超过 100 个

photo_name

string

非必填

视频名称

photo_name 和 photo_tags 填其一即可

长度不能超过 50

photo_tag

string[]

非必填

视频标签

单个标签长度不能超过 10，只支持一个标签