请求接口: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"}
文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址:http://www.mqs.net/post/8660.html
添加新评论