取得素材列表


取得素材清單

1476061831189559.jpg

#在新增了永久素材後,開發者可以分型別取得永久素材的列表。

請注意:

1、取得永久素材的列表,也包含公眾號在公眾平台官網素材管理模組中新建的圖文訊息、語音、視訊等素材
2 、臨時素材無法透過本介面取得
3、呼叫該介面需https協定

介面呼叫請求說明

http請求方式: POST

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

呼叫範例




##呼叫範例


{   "type":TYPE,   "count":COUNT
   "offset":OFFSET,}
############################################# ###參數說明###############參數######是否必須###################type# #####是######素材的類型,圖片(image)、影片(video)、語音(voice)、圖文(news)############offset# #####是######從全部素材的該偏移位置開始返回,0表示從第一個素材返回############count######是######傳回素材的數量,取值在1到20之間#############

回傳說明

永久圖文訊息素材清單的回應如下:

{
  "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
  },
  //可能有多個素材
#  ]
}


##

傳回參數說明

##name檔案名稱
參數描述
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這篇圖文訊息素材的最後更新時間
錯誤情況下的回傳JSON封包範例如下(範例為無效媒體類型錯誤):


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