| 字段 | 类型 | 说明 | 备注 | |
|---|---|---|---|---|
| code | int | 返回码 | 在获取 access_token 的时候返回 | |
| message | string | 返回信息 | 过滤筛选条件,若不传或传空则视为无限制条件 | |
| data | struct | JSON 返回值 | 过滤筛选条件,若不传或传空则视为无限制条件 | |
| details | struct | 返回值详情 | 过滤筛选条件,若不传或传空则视为无限制条件 | |
| campaign_id | long | 广告计划 ID | 过滤筛选条件,支持模糊搜索 精确查询 | |
| unit_id | long | 广告组 ID | 不超过 100 个 | |
| creative_id | long | 广告创意 ID | 过滤筛选条件;-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,11:组审核中,12:组审核未通过,14:已结束,15:组已暂停,17:组超预算,19:未达投放时间,41:审核中,42:审核未通过,46:已暂停,52:投放中,53:作品异常 -2:所有包含已删除 40:只包含已删除 不传:所有不包含已删除其他值无效 | |
| creative_name | string | 广告创意名称 | 与 end_date 同时传或同时不传;过滤筛选条件,格式为"yyyy-MM-dd",参数值对应 update_time 信息 | |
| creative_material_type | int | 素材类型 | 0:历史创意未作区分 1:竖版视频 2:横版视频 3:后贴片单图图片创意(历史类型,已下线)4:便利贴单图图片创意 11:开屏视频 12:开屏图片 | |
| 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 | 审核拒绝图片 | list 里面可以包含多个数据 | |
| cover_url | string | 封面 URL | ||
| image_token | string | 视频封面 token | 若创意使用系统自动生成的首帧图片作为封面,该 token 无法复用 | |
| dpa_template_id | long | 可选 | DPA模板ID | 通过DPA 模板查询接口获取 |
| 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 | 程序化创意物料 | 详见下方 | |
| total_count | int | 数据总数 | ||
| create_time | string | 创建时间 | 格式样例:"2019-06-11 15:17:25" | |
| update_time | string | 最后修改时间 | 格式样例:"2019-06-11 15:17:25" | |
| pic_id | string | 图片库图片 | ||
| app_grade_type | int | 审核分级类型 | 0:默认;1:审核降级(当创意发生降级时,会限制部分流量无法投放) | |
| splash_photo_ids | struct[] | 开屏视频 id | creative_material_type 为 11 时 | |
| live_creative_type | int | 粉丝直播推广创意类型 | 3:直投直播;4:作品引流 | |
| splash_pictures | struct[] | 开屏图片 | creative_material_type 为 12 时 | |
| live_track_url | string | 点击监测链接 | 计划 campaignType=16 粉丝直播推广时填写 | |
| ad_type | int | 广告计划类型 | 0:信息流,1:搜索 | |
| outer_loop_native | int | 选填 | 是否开启原生 | 0关闭,1开启,不填默认为0 |
| kol_user_type | int | 选填 | 原生达人用户类型 | 2服务号原生,3聚星达人原生, 不开启原生时此项为0 |
| dpa_style_types | int[] | 动态商品卡样式 | 14001-区域服务卡 |
| 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 | 素材类型 | |
| sticker_titles | string[] | 封面广告语 |
| new_expose_tag | |||
|---|---|---|---|
| 字段 | 类型 | 说明 | 备注 |
| text | string | 广告语 |
| splash_pictures | |||
|---|---|---|---|
| 字段 | 类型 | 说明 | 备注 |
| cover_id | long | 封面ID | |
| cover_url | string | 封面URL | |
| height | long | 图片高度 | |
| width | long | 图片宽度 |
| splash_photos | |||
|---|---|---|---|
| 字段 | 类型 | 说明 | 备注 |
| photo_id | string | 视频ID | |
| cover_url | long | 视频高度 | |
| height | long | 视频宽度 |
curl --location --request GET 'https://ad.e.kuaishou.com/rest/openapi/v1/creative/list' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": 49,
"page":1,
"page_size":1
}'{}