獲取素材列表
獲取素材列表
在新增了永久素材后，開發(fā)者可以分類型獲取永久素材的列表。
請注意：
1、獲取永久素材的列表，也包含公眾號在公眾平臺官網(wǎng)素材管理模塊中新建的圖文消息、語音、視頻等素材
2、臨時素材無法通過本接口獲取
3、調(diào)用該接口需https協(xié)議
接口調(diào)用請求說明
http請求方式: POST
https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN
調(diào)用示例
{
"type":TYPE,
"offset":OFFSET,
"count":COUNT
}
"type":TYPE,
"offset":OFFSET,
"count":COUNT
}
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| type | 是 | 素材的類型，圖片（image）、視頻（video）、語音 （voice）、圖文（news） |
| offset | 是 | 從全部素材的該偏移位置開始返回，0表示從第一個素材 返回 |
| count | 是 | 返回素材的數(shù)量，取值在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結(jié)構(gòu)
]
}
其他類型（圖片、語音、視頻）的返回如下：
{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"name": NAME,
"update_time": UPDATE_TIME,
"url":URL
},
//可能會有多個素材
]
}
"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結(jié)構(gòu)
]
}
其他類型（圖片、語音、視頻）的返回如下：
{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"name": NAME,
"update_time": UPDATE_TIME,
"url":URL
},
//可能會有多個素材
]
}
返回參數(shù)說明
| 參數(shù) | 描述 |
| total_count | 該類型的素材的總數(shù) |
| item_count | 本次調(diào)用獲取的素材的數(shù)量 |
| title | 圖文消息的標題 |
| thumb_media_id | 圖文消息的封面圖片素材id（必須是永久mediaID） |
| show_cover_pic | 是否顯示封面，0為false，即不顯示，1為true，即顯示 |
| author | 作者 |
| digest | 圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空 |
| content | 圖文消息的具體內(nèi)容，支持HTML標簽，必須少于2萬字符，小于1M，且此處會去除JS |
| url | 圖文頁的URL，或者，當獲取的列表是圖片素材列表時，該字段是圖片的URL |
| content_source_url | 圖文消息的原文地址，即點擊“閱讀原文”后的URL |
| update_time | 這篇圖文消息素材的最后更新時間 |
| name | 文件名稱 |
錯誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無效媒體類型錯誤）：
{"errcode":40007,"errmsg":"invalid media_id"}