功能简介
按素材类型获取公众号中已有的永久素材列表,方便查找历史素材的 media_id。结果会直接输出 素材列表,并同时保存完整响应 JSON 文件,便于后续留档与解析。
使用场景
需要查找很久以前上传的永久素材 media_id
在新增草稿前先筛选可用的封面图或历史素材
按分页方式浏览指定类型的永久素材
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 微信AccessToken | 字符串 | 是 | 接口调用凭证 |
| 素材类型 | 字符串 | 是 | image、video、voice、news |
| 输出目录 | 字符串 | 是 | 请选择保存 JSON 的文件夹 |
| 起始位置 | 整数 | 否 | 从第几条开始返回,默认 0 |
| 获取数量 | 整数 | 否 | 本次返回条数,取值 1 到 20,默认 20 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 素材列表 | 列表 | 否 | 本次返回的素材列表;每项结构随素材类型不同而变化 |
| 列表JSON路径 | 字符串 | 否 | 本次实际写入的 JSON 文件完整路径 |
| 返回条数 | 整数 | 否 | 本次实际返回的素材条数 |
| 素材总数 | 整数 | 否 | 当前素材类型下的素材总数 |
注意事项
素材类型:本指令按微信官方接口支持 image、video、voice、news 四种类型;不支持 thumb。
查找历史素材ID:若你不知道旧素材的 media_id,可先用本指令查询列表,再从生成的 JSON 中找到需要的 media_id,再传给【获取永久素材】或【新增草稿】等步骤。
为什么同时输出 JSON 文件:虽然本指令已经直接输出了 素材列表,但素材记录可能较多,而且不同素材类型下字段结构并不完全一致;同时保留完整 JSON 文件,更方便后续留档、排查问题,或在流程中继续读取完整响应。
文件命名:程序会自动按 wechat_material_list_素材类型_时间戳.json 创建文件
