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