请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/creative/advanced/program/list
请求方式：POST
数据格式：JSON
请求参数
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| 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 | |
| time_filter_type | int | 可选 | 按创建时间或者更新时间进行筛选 | 1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为1时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为0时，则按照更新时间进行筛选 |
| 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 | ||
| creatives | struct[] | 创建后生成的程序化创意ID |
| photo_list(程序化创意3.0字段) | 类型 | 说明 | 备注 |
|---|---|---|---|
| photo_id | number | 视频ID | |
| cover_image_token | string | 封面图片token | 通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致，使用智能抽帧时不需要传递。 |
| creative_material_type | number | 素材类型 | 1：竖版视频 2：横版视频 |
| creatives | 类型 | 说明 | 备注 |
|---|---|---|---|
| unit_id | long | 快手广告组ID | |
| creative_id | long | 创意ID |
返回样例
{ "code": 0, "message": "OK", "data": { "total_count": 0, "details": [ { "captions": [ "无参数1133" ], "creatives": [ { "unit_id": 3048974, "creative_id": 80626044 } ], "unit_id": 3048974, "horizontal_photo_ids": null, "vertical_photo_ids": [ "5238249354922787996" ], "cover_image_tokens": [ "market8a364f5e50f24657a63dba9dc8e7d93d.jpg" ], "photo_list": null, "cover_image_urls": [ "http://static.yximgs.com/udata/pkg/market8a364f5e50f24657a63dba9dc8e7d93d.jpg" ], "site_id": 0, "sticker_styles": null, "cover_slogans": null, "action_bar": "立即投保", "create_time": "2020-12-17 19:02:18", "update_time": "2020-12-17 19:02:18", "click_url": "https://open.snssdk.com/ug/ad/display/clicks?ad_platform=kuaishou&app_platform=android&surl_token=h5qx&idfa_md5=__IDFA2__&imei_md5=__IMEI2__&ip=__IP__×tamp=__TS__&adid=__AID__&creativeid=__CID__&campaignid=__DID__&androidid_md5=__ANDROIDID2__&callback=__CALLBACK__&ua=__UA__&oaid=__OAID__&csite=__CSITE__&pass_through=0-0-0-0-0-6794635432647724046", "actionbar_click_url": "", "package_name": "测试程序化创意过滤创建", "put_status": 1, "view_status": 41, "view_status_reason": "审核中", "creative_category": 0, "creative_tag": null, "new_expose_tag": null } ] }, "request_id": "a9b3485ccbb4413fbddc84e8fc525d30"}
