王尘宇

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手直播广告主ID

在获取access_token的时候返回

unit_ids

long[]

快手信息流推广组ID集

不超过一百个，当unit_ids参数不为空时，返回值total_count为0

package_name

String

程序化创意包名称

非空，0到100字符

status

int

程序化创意状态

-2：所有（包含已删除）、40：只包含已删除     不传：所有（不包含已删除）

start_date

String

起始日期

格式如 yyyy-MM-dd

end_date

String

结束时期

格式如 yyyy-MM-dd

page

int

可选

页数

page_size

int

可选

每页行数

返回参数

字段

类型

是否必填

说明

备注

code

int

message

string

data

struct

total_count

long

details

struct[]

unit_id

long

广告组ID

一个组下只能有一个程序化创意

package_name

string

程序化创意包名称，1-100 字符，

horizontal_photo_ids

string[]

横版视频 id list

横版视频和竖版视频加起来只能 1-5 个

vertical_photo_ids

string[]

竖版视频 id list

cover_image_tokens

string[]

封面 image_token

只能是 1-4 个

cover_image_urls

string[]

封面链接地址

site_id

long

建站 id

sticker_styles

int[]

封面贴纸

cover_slogans

string[]

封面广告语

action_bar

string

行动号召按钮

captions

string[]

作品广告语

只能是 1-3 个

click_url

string

第三方点击检测链接

actionbar_click_url

string

第三方ActionBar点击监控链接

put_status

int

程序化创意操作状态，1：投放，2：暂停，3：删除

view_status

int

程序化创意状态

-1：不限，

1：计划已暂停，

3：计划超预算，

6：余额不足，

11：组审核中，

12：组审核未通过，

14：已结束，

15：组已暂停，

17：组超预算，

19：未达投放时间，

40：创意已删除，

41：审核中，

42：审核未通过，

46：已暂停，

52：投放中，

53：作品异常，

55：部分素材审核通过

view_status_reason

string

程序化创意状态描述

create_time

String

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

update_time

String

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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主id

获取token时获得

unit_ids

long[]

必填

广告组id集

数量小于等于20个

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

slogans

string[]

审核不通过的封面广告语

combine_detail_views

struct[]

审核不通过和正在审核的创意组合

详情如下

unit_id

long

当前的程序化创意的广告组id

combine_detail_views

字段

类型

说明

备注

id

long

创意id

photo_id

long

视频id

已加密

cover_url

String

封面url

caption

String

作品广告语

review_status

int

审核状态

1：审核中

2：审核通过

3：不通过

review_detail

struct[]

审核信息

里面是一个String类型数据，是审核信息

put_status

int

程序化创意审核状态

程序化创意操作状态，1：投放，2：暂停，3：删除