获取素材列表

在新增了永久素材后，开发者可以分类型获取永久素材的列表。

请注意：

1、获取永久素材的列表，也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材
2、临时素材无法通过本接口获取
3、调用该接口需Https协议

接口调用请求说明

http请求方式: POST

https://api.weixin.qq.com/cgi-bin/material/batchget_material?Access_token=ACCESS_TOKEN

调用示例

{
"type":TYPE,
"offset":OFFSET,
"count":COUNT
}

参数说明

参数	是否必须	说明
type	是	素材的类型，图片（image）、视频（video）、语音（voice）、图文（news）
offset	是	从全部素材的该偏移位置开始返回，0表示从第一个素材返回
count	是	返回素材的数量，取值在1到20之间

返回说明

永久图文消息素材列表的响应如下：

{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"content": {
"news_item": [{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"author": AUTHOR,
"digest": DIGEST,
"content": CONTENT,
"url": URL,
"content_source_url": CONTETN_SOURCE_URL
},
//多图文消息会在此处有多篇文章
]
},
"update_time": UPDATE_TIME
},
//可能有多个图文消息item结构
]
}

其他类型（图片、语音、视频）的返回如下：

{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"name": NAME,
"update_time": UPDATE_TIME,
"url":URL
},
//可能会有多个素材
]
}

返回参数说明

参数	描述
total_count	该类型的素材的总数
item_count	本次调用获取的素材的数量
title	图文消息的标题
thumb_media_id	图文消息的封面图片素材id（必须是永久mediaID）
show_cover_pic	是否显示封面，0为false，即不显示，1为true，即显示
author	作者
digest	图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空
content	图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS
url	图文页的URL，或者，当获取的列表是图片素材列表时，该字段是图片的URL
content_source_url	图文消息的原文地址，即点击“阅读原文”后的URL
update_time	这篇图文消息素材的最后更新时间
name	文件名称

错误情况下的返回json数据包示例如下（示例为无效媒体类型错误）：

{"errcode":40007,"errmsg":"invalid media_id"}