获取快手广告创意信息
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/creative/list
请求方式：GET/POST
数据格式：JSON
请求参数 |
快手APP广告投放 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
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" |
display_info |
快手视频上的广告是怎么投放上去的？ | ||
字段 |
类型 |
说明 |
备注 |
description |
string |
广告语 |
|
action_bar_text |
string |
行动号召按钮文案 |
programmed_creative_material |
深圳快手短视频推广后台 | ||
字段 |
类型 |
说明 |
备注 |
materials |
struct[] |
物料信息 |
详见下方 |
sticker_style_ids |
int[] |
封面贴纸类型ID |
|
description_titles |
string[] |
广告语 |
|
sticker_titles |
string[] |
封面广告语 |
materials |
山西快手广告代理商 | ||
字段 |
类型 |
说明 |
备注 |
photo_id |
string |
视频ID |
|
image_tokens |
string[] |
封面图片token |
|
creative_material_type |
int |
素材类型 |
请求样例 |
curl -X GET \ -H 'Access-Token: eaba7b0d52cea6ce39bf442f944a4e0c' \ -H 'Content-Type: application/json' \ -d '{ "advertiser_id": 49, "page":1, "page_size":1 }' -L https://ad.e.kuaishou.com/rest/openapi/v1/creative/list |
返回样例 |
