取得素材列表
取得素材清單
#在新增了永久素材後,開發者可以分型別取得永久素材的列表。
請注意:
1、取得永久素材的列表,也包含公眾號在公眾平台官網素材管理模組中新建的圖文訊息、語音、視訊等素材
2 、臨時素材無法透過本介面取得
3、呼叫該介面需https協定
介面呼叫請求說明
http請求方式: POST
https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN
呼叫範例
##呼叫範例
"offset":OFFSET, | "count":COUNT} | |
回傳說明
永久圖文訊息素材清單的回應如下:
{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"content": "title": TITLE,
" thumb_media_id": THUMB_MEDIA_ID,
"show_cover_pic": SHOW_COVER_PIC(0 # "digest": DIGEST,
url": URL,
"content_source_url": CONTETN_SOURCE_URL
]
},
"update_time" : UPDATE_TIME
},
//可能有多個圖文訊息item結構
]
}
其他類型(圖片、語音、視訊)的回傳如下:
{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"update_time" : UPDATE_TIME,
"url":URL
},
//可能有多個素材
# ]
}
##
錯誤情況下的回傳JSON封包範例如下(範例為無效媒體類型錯誤):
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"media_id": MEDIA_ID,
"content": "title": TITLE,
" thumb_media_id": THUMB_MEDIA_ID,
"show_cover_pic": SHOW_COVER_PIC(0 # "digest": DIGEST,
url": URL,
"content_source_url": CONTETN_SOURCE_URL
]
},
"update_time" : UPDATE_TIME
},
//可能有多個圖文訊息item結構
]
}
其他類型(圖片、語音、視訊)的回傳如下:
{
"total_count": TOTAL_COUNT,
"item_count": ITEM_COUNT,
"item": [{
"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 | 這篇圖文訊息素材的最後更新時間 |
檔案名稱 |
{"errcode":40007,"errmsg":"invalid media_id"}