请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/asset/media/list
请求方式：GET/POST
数据格式：JSON
请求参数
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
| advertiser_id | long | 必填 | 快手广告主 ID | 在获取 access_token 的时候返回 |
| media | struct | 选填 | 媒体包参数结构 | 用于支持搜索 |
| is_related_unit | bool | 选填 | 是否关联广告组信息 | 默认 false |
| page | int | 选填 | 当前页码 | 默认为 1 |
| page_size | int | 选填 | 分页大小 | 默认 20，最大不超过 50 |
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
| media_id | long | 选填 | 媒体包 ID | |
| name | string | 选填 | 媒体包名字 | 修改媒体包名 |
| source_type | int | 选填 | 媒体包来源 | 0-不限，未指定，1-行业优质流量包，2-广告主自定义，默认 0 |
| pos_ids | string[] | 选填 | 快手广告开户位列表 | 修改媒体包广告位 |
| status | int | 选填 | 状态 | 删除媒体包，0-下线，1-上线，默认 1 |
返回参数
| 字段 | 类型 | 说明 | 备注 |
| code | int | 返回码 | |
| message | string | 返回信息 | |
| data | struct | 媒体包对象 |
data
| 字段 | 类型 | 说明 | 备注 |
| datails | struct[] | 关联广告组信息列表 | |
| total_count | long | 总共条数 |
details
| 字段 | 类型 | 说明 | 备注 |
| relate_units | struct[] | 关联广告组信息列表 | |
| media | struct | 媒体包信息 |
relate_units
| 字段 | 类型 | 说明 | 备注 |
| unit_id | long | 快手信息流广告组 ID | |
| unit_name | string | 广告组名字 | |
| campaign_id | long | 广告计划 ID | |
| campaign_type | int | 广告计划类型 | 计划类型，过滤筛选条件：1 - 作品推广；2 - 提升应用安装；3 - 获取电商下单；4 - 推广品牌活动；5 - 收集销售线索；6 - 保量广告；7 - 提高应用活跃 |
| put_status | int | 在投状态 | UNKNOWN_PUT_STATUS = 0; // 默认值；PUT_STATUS_OPEN = 1; // 投放；PUT_STATUS_PAUSE = 2; // 暂停；PUT_STATUS_DeleteD = 3; // 删除 |
| review_status | int | 审核状态 | UNKNOWN_REVIEW_STATUS = 0; // 默认值；REVIEW_WAIT_AUDIT = 1; //审核中；REVIEW_THROUGH = 2; //通过审核；REVIEW_NOT_THROUGH = 3; //审核未通过；BANNED = 4; //封禁 |
| media_using | bool | 媒体包是否在使用 | |
| media_type | int | 媒体包的使用类型 | 0-未知，1-定向，2-排除 |
media
| 字段 | 类型 | 说明 | 备注 |
| media_id | long | 媒体包 ID | |
| name | string | 媒体包名字 | |
| advertiser_id | long | 广告主 ID | |
| source_type | int | 媒体包来源 | 0-不限，未指定，1-行业优质流量包，2-广告主自定义，默认 0 |
| pos_ids | string[] | 广告位列表 | 修改媒体包广告位 |
| status | int | 状态 | 删除媒体包，0-下线，1-上线，默认 1 |
| create_time | long | 创建时间 | 时间戳 |
| update_time | long | 更新时间 |
curl -X POST \
-H 'Access-Token: 69d99a7c1fdf3f4b271b' \
-H 'Content-Type: application/json' \
-d '{ "advertiser_id":20000152, "media":{ "media_id":213123213, "name":"新建定向媒体包", "soruce_type":2,
}, "is_related_unit": true, "pageInfo":{ "current_page":1, "page_size":10,
}
}' -L https://ad.e.kuaishou.com/rest/openapi/v1/asset/media/list
返回样例
复制
{ "code":0, "message":"OK", "data":{ "details":[
{ "media":{ "media_id":337630, "advertiser_id":42932, "create_time":1603291774359, "update_time":1603291774359, "name":"test——2", "source_type":2, "pos_ids":[ "sadsads231afasfs", "231erew232123231"
], "status":1
}, "relate_units":[
{ "unit_id":1213, "unit_name":"媒体包测试组", "campaign_id":23213112, "campaign_type":2, "put_status":1, "media_type":1
}
]
},
{ "media":{ "media_id":33890, "account_id":42932, "create_time":1563173027191, "update_time":1563173027191, "name":"模板_test_1", "source_type":2, "pos_ids":[ "212wqeqwe1312", "23123eqweqwe21"
], "status":1
}, "relate_units":[
{ "unit_id":1213, "unit_name":"媒体包测试组", "campaign_id":23213112, "campaign_type":2, "put_status":1, "media_type":1
}
]
}
], "total_count":2
}
}
