微信企业号获取永久素材/删除永久素材/修改永久图文素材

这个纯属微信企业号的免费分享，因为在我的视频教程里面这是要收费的。。。
只为帮助有需要的人，废话少说，开始今天的3个接口讲解 ------
① 获取永久素材
② 删除永久素材
③ 修改永久素材
1.获取永久素材
通过media_id获取上传的图文消息、图片、语音、文件、视频素材。
请求说明
Https请求方式: GEThttps://qyapi.weixin.qq.com/cgi-bin/material/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID参数说明

参数	必须	说明
access_token	是	调用接口凭证
media_id	是	素材资源标识ID

权限说明
所有管理组均可调用。返回说明
a)正确时返回（这里省略了HTTP首部）：如果为图文消息素材，正确时返回结果如下{
"type": "mpnews",
"mpnews": {
"articles": [
{
"thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0HuucGBZCzw4HmLa5C",
"title": "Title01",
"author": "zs",
"digest": "airticle01",
"content_source_url": "",
"show_cover_pic": 0
},
{
"thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7oovsUPf3wG4t9N3tE",
"title": "Title02",
"author": "Author001",
"digest": "article02",
"content":"Content001",
"content_source_url": "",
"show_cover_pic": 0
}
]
}
}
如果为其他类型素材，返回结果和普通的http下载相同，请根据http头做相应的处理。{
HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: attachment; filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan 2013 10:20:18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721

Xxxx
}
b)错误时返回（这里省略了HTTP首部）：{
"errcode": "40004",
"errmsg": "invalid media_id"
}

第一个接口是最简单的，参数也比较少，一个简单的 get 请求/** 
 * 获取永久素材示例 
 */  
public static void main(String[] args) {  
    // 请求地址  
    String GetReqUrl = "https://qyapi.weixin.qq.com/cgi-bin/material/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID";  
    // 测试用的 media_id ，来自上传永久图文素材接口  
    String Media_Id = "29Ujz_kRpTZ9LOIjurDHR6d4tffci2gWMt0tIw2nDPetZsRpJPBZKhP6onvu9NFq1";  
    // 获取访问凭证  
    String accesstoken = WeixinUtil.getAccessToken(ParamesAPI.corpId,  
            ParamesAPI.secret).getToken();  
    // 替换 GetReqUrl 中的参数  
    GetReqUrl = GetReqUrl.replace("ACCESS_TOKEN", accesstoken).replace("MEDIA_ID", Media_Id);  
    // 开始请求  
    JSONObject JSONResult = WeixinUtil.HttpRequest(GetReqUrl, "GET", null);  
  
  
    // 打印结果  
    if (JSONResult != null) {  
        System.out.println("获取成功！");  
        System.out.println(JSONResult.toString());  
    } else {  
        System.out.println("获取失败！");  
    }  
  
  
}  
打印测试结果：



2.删除永久素材
通过media_id删除上传的图文消息、图片、语音、文件、视频素材。
请求说明
Https请求方式: GEThttps://qyapi.weixin.qq.com/cgi-bin/material/del?access_token=ACCESS_TOKEN&media_id=MEDIA_ID参数说明

参数	必须	说明
access_token	是	调用接口凭证
media_id	是	素材资源标识ID

权限说明
所有管理组均可调用。返回结果

{
"errcode": 0,
"errmsg": "deleted"
}

这个相比上一个更简单多了，直接编写 main 测试/** 
 * 删除永久素材示例 
 */  
public static void main(String[] args) {  
    // 请求地址  
    String GetReqUrl = "https://qyapi.weixin.qq.com/cgi-bin/material/del?access_token=ACCESS_TOKEN&media_id=MEDIA_ID";  
    // 测试用的 media_id ，来自上传永久图文素材接口  
    String Media_Id = "29Ujz_kRpTZ9LOIjurDHR6d4tffci2gWMt0tIw2nDPetZsRpJPBZKhP6onvu9NFq1";  
    // 获取访问凭证  
    String accesstoken = WeixinUtil.getAccessToken(ParamesAPI.corpId,  
            ParamesAPI.secret).getToken();  
    // 替换 GetReqUrl 中的参数  
    GetReqUrl = GetReqUrl.replace("ACCESS_TOKEN", accesstoken).replace("MEDIA_ID", Media_Id);  
    // 开始请求  
    JSONObject JSONResult = WeixinUtil.HttpRequest(GetReqUrl, "GET", null);  
    // 打印结果  
    if (JSONResult != null) {  
        System.out.println("删除成功！");  
        System.out.println(JSONResult.toString());  
    } else {  
        System.out.println("删除失败！");  
    }  
  
}
打印测试结果：



3.修改永久图文素材
/**
* 修改永久图文素材示例
*/
public static void main(String[] args) {
// 已经上传成功的永久图文素材
String media_id = "29Ujz_kRpTZ9LOIjurDHR6d4tffci2gWMt0tIw2nDPesE3KzbigjS8wlsp1pAnPhU";
// 定义群发修改后的图文 JSON 头(主要用于展示修改后的永久图文素材对比)
String SendForeverNewsJSONHeader = "{\"touser\": \"@all\", \"toparty\":\"@all\", \"msgtype\": \"mpnews\", \"agentid\": 1,\"mpnews\":{\"media_id\": \"%s\"}, \"safe\": 0}";
// 定义 JSON 头
String JSONHeadr = "{\"media_id\": \"%s\",\"mpnews\":{\"articles\":%s}}";
// 定义 JSON 主体
List<String> JSONBody = new ArrayList<String>();

// 开始修改主体
/** 修改第一个图文主体 */
ForeverArticle mArticle1 = new ForeverArticle();
// 修改图文消息标题
mArticle1.title = "修改永久图文素材测试-1";
// 修改图文消息缩略图的media_id, 可以在上传永久素材接口中获得
mArticle1.thumb_media_id = "2UswksB2VRMzWw054wu75UyC32k1UDMVXVQGOtxMZsbXtvWULY9PZyXNsuyIvnUGIOwDYTX-nWTrLwhycqZxeDA";
// 图文消息的作者
mArticle1.author = "Engineer-Jsp";
// 图文消息点击“阅读原文”之后的页面链接
mArticle1.content_source_url = "http://www.engineer-jsp.cn/";
// 修改图文消息的内容，支持html标签
mArticle1.content = "修改永久图文素材测试-1";
// 修改图文消息的描述
mArticle1.digest = "修改永久图文素材测试-1";
// 是否显示封面，1为显示，0为不显示。默认为0
mArticle1.show_cover_pic = "1";
// 将该主体添加到 JSON 主体中
JSONBody.add(mArticle1.getJSONObject());

/** 修改第二个图文主体 */
ForeverArticle mArticle2 = new ForeverArticle();
// 修改图文消息标题
mArticle2.title = "修改永久图文素材测试-2";
// 图文消息缩略图的media_id, 可以在上传永久素材接口中获得
mArticle2.thumb_media_id = "2oPn4I5ihl3OYAr2-x3xwvAVzdcQbxb3FWJBCzJtMj8jlF5H1I6H8Hs53K2VpMrejF1RJhE6jCTVqc_dGJM9zJQ";
// 图文消息的作者
mArticle2.author = "Engineer-Jsp";
// 图文消息点击“阅读原文”之后的页面链接
mArticle2.content_source_url = "http://www.engineer-jsp.cn/";
// 修改图文消息的内容，支持html标签
mArticle2.content = "修改永久图文素材测试-2";
// 修改图文消息的描述
mArticle2.digest = "修改永久图文素材测试-2";
// 是否显示封面，1为显示，0为不显示。默认为0
mArticle2.show_cover_pic = "0";
// 将该主体添加到 JSON 主体中
JSONBody.add(mArticle2.getJSONObject());

/** 修改第二个图文主体 */
ForeverArticle mArticle3 = new ForeverArticle();
// 修改图文消息标题
mArticle3.title = "修改永久图文素材测试-3";
// 图文消息缩略图的media_id, 可以在上传永久素材接口中获得
mArticle3.thumb_media_id = "27N7vimhmaV0kMGvy5P8KCqqTC0MK0XGVd0WSyqp5xcxxJ-BEbgHllRVjAIIRh7wjZG2Pr-sCBhW2D12fsNk10A";
// 图文消息的作者
mArticle3.author = "Engineer-Jsp";
// 图文消息点击“阅读原文”之后的页面链接
mArticle3.content_source_url = "http://www.engineer-jsp.cn/";
// 修改图文消息的内容，支持html标签
mArticle3.content = "修改永久图文素材测试-3";
// 修改图文消息的描述
mArticle3.digest = "修改永久图文素材测试-3";
// 是否显示封面，1为显示，0为不显示。默认为0
mArticle3.show_cover_pic = "0";
// 将该主体添加到 JSON 主体中
JSONBody.add(mArticle3.getJSONObject());

// 将所有 JSON 主体添加到 JSON 头
String PostJSONHeader = String.format(JSONHeadr, media_id, JSONBody
.toString());

System.out.println(PostJSONHeader);

// 上传地址
String PostUrl = "https://qyapi.weixin.qq.com/cgi-bin/material/update_mpnews?access_token=ACCESS_TOKEN";
// 获取 accesstoken
String access_token = WeixinUtil.getAccessToken(ParamesAPI.corpId,
ParamesAPI.secret).getToken();
// 替换 accesstoken
PostUrl = PostUrl.replace("ACCESS_TOKEN", access_token);

JSONObject JSONResult = WeixinUtil.HttpRequest(PostUrl, "POST",
PostJSONHeader);

if (JSONResult.has("errcode") && JSONResult.getInt("errcode") == 0) {
System.out.println("修改永久图文素材成功！正在进行群发...");

// 发送修改后的永久图文素材给所有关注用户的测试
String POST_URL = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN";
String PostSendForeverNesData = String.format(
SendForeverNewsJSONHeader, media_id);
int result = WeixinUtil.PostMessage(access_token, "POST", POST_URL,
PostSendForeverNesData);
// 打印结果
if (0 == result) {
System.out.println("发送成功");
} else {
System.out.println("发送失败");
}
}
}
ForeverArticle 类
package jsp.weixin.media.util;

public class ForeverArticle {

private String JSONFlags = "{\"title\": \"%s\",\"thumb_media_id\": \"%s\",\"author\": \"%s\",\"content_source_url\": \"%s\",\"content\": \"%s\",\"digest\": \"%s\",\"show_cover_pic\": \"%s\"}";

public String title;

public String thumb_media_id;

public String author;

public String content_source_url;

public String content;

public String digest;

public String show_cover_pic;

public String getJSONObject() {
return String.format(JSONFlags, title, thumb_media_id, author,
content_source_url, content, digest, show_cover_pic);
}
}

核心类 WeixinUtil package jsp.weixin.ParamesAPI.util;
/**
* @author Engineer-Jsp
* @date 2014.10.09
* 请求数据通用类*/
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import jsp.weixin.menu.util.Menu;
import net.sf.json.JSONObject;
public class WeixinUtil {
/**
* 发起https请求并获取结果
*
* @param requestUrl 请求地址
* @param requestMethod 请求方式（GET、POST）
* @param outputStr 提交的数据
* @return JSONObject 返回JSONObject对象(通过JSONObject.get(key)的方式获取json对象的属性值)
* @author Engineer.Jsp
*/
public static JSONObject HttpRequest(String request , String RequestMethod , String output ){
@SuppressWarnings("unused")
// 定义 JSONObject 对象
JSONObject jsonObject = null;
// buffer 缓冲流
StringBuffer buffer = new StringBuffer();
try {
//建立连接
URL url = new URL(request);
// 获取 HttpURLConnection对象
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// 设置输出流
connection.setDoOutput(true);
// 设置输入流
connection.setDoInput(true);
// 是否使用缓存
connection.setUseCaches(false);
// 请求方式
connection.setRequestMethod(RequestMethod);
// 流不为空
if(output!=null){
// 获取流
OutputStream out = connection.getOutputStream();
// 写数据流 UTF-8 编码
out.write(output.getBytes("UTF-8"));
// 关闭
out.close();
}
//流处理
InputStream input = connection.getInputStream();
// 读取流 UTF-8 编码
InputStreamReader inputReader = new InputStreamReader(input,"UTF-8");
// 缓冲流 buffer
BufferedReader reader = new BufferedReader(inputReader);
// 定义 String 来读取每一行
String line;
// 循环读取每一行，知道数据没有了，意思是读取完了
while((line=reader.readLine())!=null){
// 添加到StringBuffer字符流里面
buffer.append(line);
}
//关闭连接、释放资源
reader.close();
// 关闭
inputReader.close();
// 关闭
input.close();
// 强制释放对象，缓解JVM内存
input = null;
// 关闭连接
connection.disconnect();
// 把写到 StringBuffer 字符流的数据用 JSONObject.fromObject 函数转换成 JSONObject 对象
jsonObject = JSONObject.fromObject(buffer.toString());
System.out.println(buffer.toString());
} catch (Exception e) {
}
// 如果为空，返回一个空对象，否则返回jsonObject实例对象
return jsonObject;
}

// 获取AccessToken的接口地址（GET）
public final static String access_token_url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=CorpID&corpsecret=SECRET";
/**
* 获取AccessToken
* @param corpID 企业Id
* @param secret 管理组的凭证密钥，每个secret代表了对应用、通讯录、接口的不同权限；不同的管理组拥有不同的secret
* @return accessToken AccesstToken 的对象
* @author Engineer.Jsp
*/
public static AccessToken getAccessToken(String corpID, String secret) {

// 这里我们定义一个 AccessToken 对象
AccessToken accessToken = null;

// 定义一个 String 来接收请求地址 access_token_url 的替换之后的值，replace 代表替换
// replace("CorpID", corpID) 代表把 access_token_url 的 "CorpID" 字符替换成参数 corpID
// replace("SECRET", secret) 代表把 access_token_url 的 "SECRET" 字符替换成参数 secret
String requestUrl = access_token_url.replace("CorpID", corpID).replace("SECRET", secret);

// 定义一个 JSONObject 对象来接收请求结果，这里不懂JSONObject可以去百度一下，它是一种数据交互字符格式
// 稍后会贴出 HttpRequest(requestUrl, "GET", null) 通用请求方法，这个方法请务必掌握！后期的很多请求
// 都是采用此通用方法，也请把整篇章节看完后在进行写代码，否则会出现参数或函数混淆，导致浪费不必要的时间！
JSONObject jsonObject = HttpRequest(requestUrl, "GET", null);

// 如果请求成功，表示 jsonObject 里面有东西，它不为空，表示取到了JSONObject数据
if (null != jsonObject) {
// try/catch 代表捕获异常 关于他们的用法与意义，请参照本人博客，里面讲解得很详细，附带案例
// 博客地址：http://blog.csdn.net/jspping/article/details/50340383
try {
// 因为取到了数据，所以这里我们创建一个 AccessToken 对象来接收 access_token 和 expires_in
accessToken = new AccessToken();
// 给accessToken set 一个Token值，并且保存起来
accessToken.setToken(jsonObject.getString("access_token"));
// 给accessToken set 一个ExpiresIn值，并且保存起来
accessToken.setExpiresIn(jsonObject.getInt("expires_in"));
// 打印
System.out.println("获取token成功:"+jsonObject.getString("access_token")+"————"+jsonObject.getInt("expires_in"));
} catch (Exception e) {
accessToken = null;
// 获取token失败
String error = String.format("获取token失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));
// 打印
System.out.println(error);
}
}
// 如果有值，返回一个accessToken实例对象，否则，返回一个空对象
return accessToken;
}
// 菜单创建（POST）
public static String menu_create_url = "https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=0";

/**
* 创建菜单
*
* @param menu 菜单实例
* @param accessToken 有效的access_token
* @param agentid 企业应用的id，整型，可在应用的设置页面查看
* @return 0表示成功，其他值表示失败
*/
public static int createMenu(Menu menu, String accessToken) {
int result = 0;

// 拼装创建菜单的url
String url = menu_create_url.replace("ACCESS_TOKEN", accessToken);
// 将菜单对象转换成json字符串
String jsonMenu = JSONObject.fromObject(menu).toString();
// 调用接口创建菜单
JSONObject jsonObject = HttpRequest(url, "POST", jsonMenu);
// 测试数据
System.out.println(jsonObject);
if (null != jsonObject) {
if (0 != jsonObject.getInt("errcode")) {
result = jsonObject.getInt("errcode");
String error = String.format("创建菜单失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));
System.out.println(error);
}
}

return result;
}
public static String URLEncoder(String str){
String result = str ;
try {
result = java.net.URLEncoder.encode(result,"UTF-8");
} catch (Exception e) {
e.printStackTrace();
}
return result;
}
/**
* 根据内容类型判断文件扩展名
*
* @param contentType 内容类型
* @return
*/
public static String getFileEndWitsh(String contentType) {
String fileEndWitsh = "";
if ("image/jpeg".equals(contentType))
fileEndWitsh = ".jpg";
else if ("audio/mpeg".equals(contentType))
fileEndWitsh = ".mp3";
else if ("audio/amr".equals(contentType))
fileEndWitsh = ".amr";
else if ("video/mp4".equals(contentType))
fileEndWitsh = ".mp4";
else if ("video/mpeg4".equals(contentType))
fileEndWitsh = ".mp4";
// new add
else if ("image/png".equals(contentType))
fileEndWitsh = ".png";
return fileEndWitsh;
}
/**
* 数据提交与请求通用方法
* @param access_token 凭证
* @param RequestMt 请求方式
* @param RequestURL 请求地址
* @param outstr 提交json数据
* */
public static int PostMessage(String access_token ,String RequestMt , String RequestURL , String outstr){
int result = 0;
RequestURL = RequestURL.replace("ACCESS_TOKEN", access_token);
JSONObject jsonobject = WeixinUtil.HttpRequest(RequestURL, RequestMt, outstr);
if (null != jsonobject) {
if (0 != jsonobject.getInt("errcode")) {
result = jsonobject.getInt("errcode");
String error = String.format("操作失败 errcode:{%s} errmsg:{%s}", jsonobject.getInt("errcode"), jsonobject.getString("errmsg"));
System.out.println(error);
}
}
return result;
}
public static void main(String[] args) {
// String corpID = "您的企业号ID";
// String secret = "管理组密钥";
// AccessToken token = getAccessToken(corpID, secret);
// System.out.println("获取到的AccessToeken: " + token.getToken());
// System.out.println("有效时间 : " + token.getExpiresIn());
}
}


打印测试结果：



未修改前的永久图文素材：


修改后的永久图文素材：



本地修改的上传图片：



本篇3个接口就这么多内容，谢谢观看，希望对大家有帮助！