初识微信公众平台,获取永久素材列表
原创在新增了永久素材后，开发者可以分类型获取永久素材的列表。需注意的事项如下。
（1）永久素材的列表中也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材。
（2）临时素材无法通过本接口获取。
（3）调用该接口需要 HTTPS。
• 接口调用请求说明。
HTTP 请求方式：POST。
https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN
调用示例：
1. { 2. "type":TYPE, 3. "offset":OFFSET, 4. "count":COUNT 5. }
表 8-34 对所用参数进行了说明，具体如下。
表 8-34 获取永久素材列表参数说明
| 参数名称 | 是否必须 | 说明 |
| type | 是 | 素材的类型，图片（image）、视频（video）、语音（voice）、图文（news） |
| offset | 是 | 从全部素材的该偏移位置开始返回，0 表示从第一个素材返回 |
| count | 是 | 返回素材的数量，取值在 1～20 之间 |
• 返回说明。
永久图文消息素材列表的返回结果如下：
1. { 2. 「total_count」: TOTAL_COUNT， 3. 「item_count」: ITEM_COUNT， 4. 「item」: [{ 5. 「media_id」: MEDIA_ID， 6. 「content」: { 7. 「news_item」: [{ 8. 「title」: TITLE， 9. 「thumb_media_id」: THUMB_MEDIA_ID， 10. 「show_cover_pic」: SHOW_COVER_PIC(0 / 1)， 11. 「author」: AUTHOR， 12. 「digest」: DIGEST， 13. 「content」: CONTENT， 14. 「url」: URL， 15. 「content_source_url」: CONTETN_SOURCE_URL 16. }， 17. //多图文消息会在此处有多篇文章 18. ] 19. }， 20. 「update_time」: UPDATE_TIME 21. }， 22. //可能有多个图文消息 item 结构 23. ] 24. }
其他类型（图片、语音、视频）的返回结果如下：
1. { 2. 「total_count」: TOTAL_COUNT， 3. 「item_count」: ITEM_COUNT， 4. 「item」: [{ 5. 「media_id」: MEDIA_ID， 6. 「name」: NAME， 7. 「update_time」: UPDATE_TIME， 8. 「url」:URL 9. }， 10. //可能会有多个素材 11. ] 12. }
表 8-35 对获取永久图文消息素材列表返回参数进行了说明。
表 8-35 获取永久图文消息素材列表返回参数说明
错误情况下的返回 JSON 数据包示例如下（示例为无效媒体类型错误）：
{"errcode":40007,"errmsg":"invalid media_id"}
版权保护: 本文由 李斯特 原创，转载请保留链接: https://www.wechatadd.com/artdet/9580
- 上一篇：初识微信公众平台,获取接口凭证方法
- 下一篇：初识微信公众平台,接口使用
