字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

campaign_id

long

可选

快手视频广告计划ID

过滤筛选条件，若不传或传空则视为无限制条件

unit_id

long

可选

快手信息流广告组ID

过滤筛选条件，若不传或传空则视为无限制条件

creative_id

long

可选

快手短视频广告创意ID

过滤筛选条件，若不传或传空则视为无限制条件

creative_name

string

可选

快手直播广告创意名称

精确查询

creative_ids

long[]

可选

快手小店广告创意ID集

不超过 100 个

status

int

可选

快手电商广告创意状态

-2：所有包含已删除

40：只包含已删除

不传：所有不包含已删除

其他值无效

start_date

string

可选

开始时间

与end_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

end_date

string

可选

结束时间

与start_date同时传或同时不传；

过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

page

int

可选

请求的页码数

默认为1

page_size

int

可选

请求的每页行数

默认为20

actionbar_click_url

string

可选

第三方点击按钮监测链接

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

details

struct

返回值详情

campaign_id

long

广告计划ID

unit_id

long

广告组ID

creative_id

long

广告创意ID

creative_name

string

广告创意名称

creative_material_type

int

素材类型

0：历史创意未作区分

1：竖版视频

2：横版视频

3：后贴片单图图片创意（历史类型，已下线）

4：便利贴单图图片创意

photo_id

string

视频作品ID

material_url

string[]

单图创意url

image_tokens

string[]

单图创意image_token

status

int

广告创意状态

（优先先看这个状态,计算结果）

-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，40：已删除，41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常，54：视频审核通过可投放滑滑场景，55：部分素材审核失败

put_status

int

投放状态

（操作结果）

1：投放中；2：暂停 3：删除

create_channel

int

创建渠道

0：投放后台创建；1：Marketing API创建

review_detail

string

审核拒绝理由

reject_video_snapshot

List<String>

审核拒绝图片

list里面可以包含多个数据

cover_url

string

封面URL

image_token

string

视频封面token

若创意使用系统自动生成的首帧图片作为封面，该token无法复用

first_frame_type

int

视频封面来源

1：首帧，0：非首帧

cover_width

long

封面图宽度

cover_height

long

封面图高度

overlay_bg_url

string

动态词包原始封面图片URL

overlay_bg_image_token

string

动态词包原始封面图片token

sticker_title

string

封面广告语标题

overlay_type

string

贴纸样式类型

display_info

struct

广告展示信息

详情见下方

short_slogan

string

便利贴创意短广告语

expose_tag

string

广告标签

new_expose_tag

string[]

广告标签2期

site_id

long

安卓下载中间页ID

click_track_url

string

点击监测链接

若出现与后台显示不一致，以文档为准即可

impression_url

string

第三方开始播放监测链接

若出现与后台显示不一致，以文档为准即可

ad_photo_played_t3s_url

string

第三方有效播放监测链接

仅历史个别账户使用

programmed_creative_material

struct

程序化创意物料

详见下方

creativeStatusType

int

否为僵尸创意

1：僵尸

0：非僵尸

total_count

int

数据总数

create_time

string

创建时间

格式样例："2019-06-11 15:17:25"

update_time

string

最后修改时间

格式样例："2019-06-11 15:17:25"

字段

类型

说明

备注

photo_id

string

视频ID

image_tokens

string[]

封面图片token

creative_material_type

int

素材类型