|
素材管理-获取素材列表
在新增了永久素材后,开发者可以分类型获取永久素材的列表。
请注意:
1、获取永久素材的列表,也会包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材(但需要先通过获取素材列表来获知素材的media_id)2、临时素材无法通过本接口获取3、调用该接口需https协议接口调用请求说明
http请求方式: POSThttps://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, "content_source_url": CONTETN_SOURCE_URL }, //多图文消息会在此处有多篇文章 ] }, "update_time": UPDATE_TIME }, //可能有多个图文消息item结构 ]}IT论坛类型(图片、语音、视频)的返回如下:
{ "total_count": TOTAL_COUNT, "item_count": ITEM_COUNT, "item": [{ "media_id": MEDIA_ID, "name": NAME, "update_time": UPDATE_TIME }, //可能会有多个素材 ]}返回参数说明
参数 | 描述 | total_count | 该类型的素材的总数 | item_count | 本次调用获取的素材的数量 | title | 图文消息的标题 | thumb_media_id | 图文消息的封面图片素材id(必须是永久mediaID) | show_cover_pic | 是否显示封面,0为false,即不显示,1为true,即显示 | author | 作者 | digest | 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空 | content | 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS | content_source_url | 图文消息的原文地址,即点击“阅读原文”后的URL | update_time | 这篇图文消息素材的最后更新时间 | name | 文件名称 | 错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误):
{"errcode":40007,"errmsg":"invalid media_id"}
素材管理-获取素材列表
摘自:http://mp.weixin.qq.com/wiki/12/2108cd7aafff7f388f41f37efa710204.html
|
|