WeixinMPlatformProxy (weixin-mp 1.5.0 API)

java.lang.Object
- cn.ipokerface.weixin.mp.proxy.WeixinMPlatformProxy

```
public class WeixinMPlatformProxy
extends Object
```
Created by PokerFace Create Date 2019-12-27. Email: 214888341@163.com Version 1.0.0
Description:

构造器概要

构造器
构造器和说明
`WeixinMPlatformProxy(TicketPermanentManager perTicketManager, TokenManager componentTokenManager, String userAuthRedirectUrl, String openUserAuthRedirctUrl)` 第三方组件方式创建微信接口实现(永久刷新令牌机制)
`WeixinMPlatformProxy(WeixinAccount weixinAccount, AbstractCacheStorager<Token> cacheStorager)` 微信接口实现

方法概要

All Methods Instance Methods Concrete Methods
限定符和类型	方法和说明
`ApiResult`	`batchBlacklist(boolean blacklist, String... openIds)` 黑名单操作
`ApiResult`	`clearQuota()` 接口调用次数调用清零：公众号调用接口并不是无限制的。
`ApiResult`	`closeCustomSession(String userOpenId, String kfAccount, String text)` 关闭客服会话
`MediaCounter`	`countMaterialMedia()` 获取永久媒体素材的总数 .图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000
`String`	`createCardCoupon(CardCoupon cardCoupon)` 创建卡券:创建卡券接口是微信卡券的基础接口，用于创建一类新的卡券，获取card_id，创建成功并通过审核后，商家可以通过文档提供的其他接口将卡券下发给用户，每次成功领取，库存数量相应扣除。
`QrcodeResult`	`createCardQR(Integer expireSeconds, CardQR... cardQRs)` 创建卡券二维码：开发者可调用该接口生成一张卡券二维码供用户扫码后添加卡券到卡包。
`ApiResult`	`createCustomAccount(String id, String name)` 新增客服账号
`String`	`createCustomMenu(List<Button> buttons, MenuMatchRule matchRule)` 创建个性化菜单
`ApiResult`	`createCustomSession(String userOpenId, String kfAccount, String text)` 创建客服会话开发者可以使用本接口，为多客服的客服工号创建会话，将某个客户直接指定给客服工号接待，需要注意此接口不会受客服自动接入数以及自动接入开关限制。
`ApiResult`	`createMenu(List<Button> buttons)` 自定义菜单
`QrcodeResult`	`createQrcode(QrcodeParameter parameter)` 生成带参数的二维码
`Tag`	`createTag(String name)` 创建标签
`List<?>`	`datacube(DatacubeType datacubeType, Date date)` 查询日期跨度为0的统计数据(当天)
`List<?>`	`datacube(DatacubeType datacubeType, Date beginDate, Date endDate)` 数据统计
`List<?>`	`datacube(DatacubeType datacubeType, Date beginDate, int offset)` 数据统计
`List<?>`	`datacube(DatacubeType datacubeType, int offset, Date endDate)` 数据统计
`ApiResult`	`deleteComment(String msgid, int index, String commentId)` 删除评论
`ApiResult`	`deleteCommentReply(String msgid, int index, String commentId)` 删除回复
`ApiResult`	`deleteCustomAccount(String id)` 删除客服账号
`ApiResult`	`deleteCustomMenu(String menuId)` 删除个性化菜单
`ApiResult`	`deleteMaterialMedia(String mediaId)` 删除永久媒体素材
`ApiResult`	`deleteMenu()` 删除菜单
`ApiResult`	`deleteMessageNews(String msgid)` 删除群发消息
`ApiResult`	`deleteMessageNews(String msgid, int articleIndex)` 删除群发消息请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片
`ApiResult`	`deleteTag(int tagId)` 删除标签
`ApiResult`	`deleteTemplate(String templateId)` 删除模板
`List<MpArticle>`	`downloadArticle(String mediaId)` 下载永久图文素材
`MediaDownloadResult`	`downloadMedia(String mediaId, boolean isMaterial)` 下载媒体文件
`List<String>`	`getAllBalcklistOpenIds()` 获取公众号全部的黑名单列表请慎重使用当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
`List<User>`	`getAllFollowing()` 获取公众号全部的关注者列表请慎重使用当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
`List<String>`	`getAllFollowingOpenIds()` 获取公众号全部的关注者列表请慎重使用当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
`List<Menu>`	`getAllMenu()` 查询全部菜单(包含个性化菜单)
`List<User>`	`getAllTagFollowing(int tagId)` 获取标签下全部的粉丝列表请慎重使用
`List<String>`	`getAllTagFollowingOpenIds(int tagId)` 获取标签下全部的粉丝列表请慎重使用
`List<TemplateMessageInfo>`	`getAllTemplates()` 获取模板列表
`ArticleProxy`	`getArticleProxy()`
`AutoReplySetting`	`getAutoReplySetting()` 获取公众号当前使用的自动回复规则，包括关注后自动回复、消息自动回复（60分钟内触发一次）、关键词自动回复。
`Following`	`getBalcklistOpenIds(String nextOpenId)` 获取公众号的黑名单列表
`CardProxy`	`getCardProxy()`
`List<CustomChatRecord>`	`getCustomChatRecord(Date startTime, Date endTime, int number)` 客服聊天记录
`CustomProxy`	`getCustomProxy()`
`CustomChatSession`	`getCustomSession(String userOpenId)` 获取客户的会话状态:获取客户当前的会话状态。
`DataProxy`	`getDataProxy()`
`Following`	`getFollowing(String nextOpenId)` 获取公众号一定数量(10000)的关注者列表请慎重使用
`Following`	`getFollowingOpenIds(String nextOpenId)` 获取公众号一定数量(10000)的关注者列表
`MediaProxy`	`getMediaProxy()`
`List<Button>`	`getMenu()` 查询菜单
`MenuProxy`	`getMenuProxy()`
`MenuSetting`	`getMenuSetting()` 获取公众号当前使用的自定义菜单的配置，如果公众号是通过API调用设置的菜单，则返回菜单的开发配置，而如果公众号是在公众平台官网通过网站功能发布菜单，则本接口返回运营者设置的菜单配置。
`String`	`getMessageNewStatus(String msgId)` 查询群发发送状态
`MessageProxy`	`getMessageProxy()`
`NotifyProxy`	`getNotifyProxy()`
`OauthProxy`	`getOauthProxy()`
`QrcodeProxy`	`getQrcodeProxy()`
`ShakeProxy`	`getShakeProxy()`
`String`	`getShorturl(String url)` 长链接转短链接
`Following`	`getTagFollowing(int tagId, String nextOpenId)` 获取标签下粉丝列表请慎重使用
`Following`	`getTagFollowingOpenIds(int tagId, String nextOpenId)` 获取标签下粉丝列表
`TagProxy`	`getTagProxy()`
`String`	`getTemplateId(String shortId)` 获取模板ID
`TemplateMessageProxy`	`getTemplateMessageProxy()`
`TokenManager`	`getTicketManager(TicketType ticketType)` 获取JSSDK Ticket的tokenManager
`TokenManager`	`getTokenManager()` token管理
`ToolsProxy`	`getToolsProxy()`
`User`	`getUser(String openId)` 获取用户信息
`User`	`getUser(String openId, Lang lang)` 获取用户信息在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID（加密后的微信号,每个用户对每个公众号的OpenID是唯一的,对于不同公众号, 同一用户的openid不同）,公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间
`UserProxy`	`getUserProxy()`
`List<User>`	`getUsers(Lang lang, String... openIds)` 批量获取用户信息
`List<User>`	`getUsers(String... openIds)` 批量获取用户信息
`Integer[]`	`getUserTags(String openId)` 获取用户身上的标签列表
`List<String>`	`getWechatServerIp()` 获取微信服务器IP地址
`WeixinAccount`	`getWeixinAccount()` 获取微信账号信息
`ApiResult`	`inviteKfAccount(String kfAccount, String inviteAccount)` 邀请绑定客服帐号新添加的客服帐号是不能直接使用的，只有客服人员用微信号绑定了客服账号后，方可登录Web客服进行操作。
`List<ArticleComment>`	`listAllArticleComments(ArticleComment.ArticleCommentType commentType, String msgid, int index)` 获取评论列表
`List<MediaItem>`	`listAllMaterialMedia(MediaType mediaType)` 获取全部的媒体素材
`PageData<ArticleComment>`	`listArticleComments(Pageable page, ArticleComment.ArticleCommentType commentType, String msgid, int index)` 获取评论列表
`List<CustomAccount>`	`listCustomAccount()` 获取公众号中所设置的客服基本信息，包括客服工号、客服昵称、客服登录账号
`List<CustomChatSession>`	`listCustomSession(String kfAccount)` 获取客服的会话列表:获取某个客服正在接待的会话列表。
`CustomChatSession.CustomChatSessionCounter`	`listCustomWaitSession()` 获取未接入会话列表:获取当前正在等待队列中的会话列表，此接口最多返回最早进入队列的100个未接入会话
`MediaRecord`	`listMaterialMedia(MediaType mediaType, Pageable pageable)` 获取媒体素材记录列表
`List<CustomOnlineAccount>`	`listOnlineCustomAccount()` 获取在线客服在线状态（手机在线、PC客户端在线、手机和PC客户端全都在线）、客服自动接入最大值、客服当前接待客户数
`List<Tag>`	`listTags()` 获取标签
`ApiResult`	`markelectComment(boolean markelect, String msgid, int index, String commentId)` 评论标记/取消精选
`List<Button>`	`matchCustomMenu(String userId)` 测试个性化菜单匹配结果
`String[]`	`messageArticleByGroupId(List<MpArticle> articles, int groupId)` 分组ID群发图文消息
`String[]`	`messageArticleByOpenIds(List<MpArticle> articles, boolean ignoreReprint, String... openIds)` openid群发图文消息
`String[]`	`messageArticleByTagId(List<MpArticle> articles, int tagId, boolean ignoreReprint)` 标签群发图文消息
`String[]`	`messageByGroupId(MultiMessageTuple tuple, boolean isToAll, int groupId)` 群发消息在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息, 如消息有时会进行审核、服务器不稳定等,此外,群发任务一般需要较长的时间才能全部发送完毕
`String[]`	`messageByOpenIds(MultiMessageTuple tuple, String... openIds)` openId群发消息
`String[]`	`messageByTagId(MultiMessageTuple tuple, int tagId)` 标签群发消息
`String[]`	`messageToAll(MultiMessageTuple tuple)` 群发消息给所有粉丝
`ApiResult`	`openComment(boolean open, String msgid, int index)` 打开/关闭已群发文章评论
`ApiResult`	`previewMessageNews(String toUser, String toWxName, MultiMessageTuple tuple)` 预览群发消息开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版
`ApiResult`	`remarkUserName(String openId, String remark)` 设置用户备注名
`ApiResult`	`replyComment(String msgid, int index, String commentId, String content)` 回复评论
`SemResult`	`semantic(SemQuery semQuery)` 语义理解
`ApiResult`	`sendNotify(NotifyMessage notify)` 发送客服消息(在48小时内不限制发送次数)
`ApiResult`	`sendNotify(NotifyMessage notify, String kfAccount)` 发送客服消息(在48小时内不限制发送次数)
`String`	`sendTmplMessage(TemplateMessage tplMessage)` 发送模板消息
`ApiResult`	`setCardPayCell(String cardId, boolean isOpen)` 设置卡券买单：创建卡券之后，开发者可以通过设置微信买单接口设置该card_id支持微信买单功能。
`ApiResult`	`setCardSelfConsumeCell(String cardId, boolean isOpen)` 设置自助核销:创建卡券之后，开发者可以通过设置微信买单接口设置该card_id支持自助核销功能。
`ApiResult`	`setTmplIndustry(IndustryType... industryTypes)` 设置所属行业(每月可修改行业1次，账号仅可使用所属行业中相关的模板)
`ApiResult`	`taggingUsers(int tagId, String... openIds)` 批量为用户打标签:标签功能目前支持公众号为用户打上最多三个标签
`ApiResult`	`untaggingUsers(int tagId, String... openIds)` 批量为用户取消标签
`ApiResult`	`updateCustomAccount(String id, String name)` 更新客服账号
`ApiResult`	`updateMaterialArticle(String mediaId, int index, MpArticle article)` 更新永久图文素材
`ApiResult`	`updateTag(Tag tag)` 更新标签
`ApiResult`	`uploadCustomAvatar(String accountId, InputStream is, String fileName)` 上传客服头像
`String`	`uploadImage(InputStream is, String fileName)` 上传图文消息内的图片获取URL 请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。
`String`	`uploadMaterialArticle(List<MpArticle> articles)` 上传永久图文素材、新增的永久素材也可以在公众平台官网素材管理模块中看到,永久素材的数量是有上限的，请谨慎新增。
`String`	`uploadMaterialVideo(InputStream is, String fileName, String title, String introduction)` 上传永久视频素材
`MediaUploadResult`	`uploadMedia(boolean isMaterial, InputStream is, String fileName)` 上传媒体文件此接口只包含图片、语音、缩略图、视频(临时)四种媒体类型的上传
`String`	`uploadMessageArticle(List<MpArticle> articles)` 上传群发的图文消息,一个图文消息支持1到10条图文
`MpVideoMessageTuple`	`uploadVideo(InputStream is, String fileName, String title, String description)` 上传群发中的视频素材

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - WeixinMPlatformProxy
```
public WeixinMPlatformProxy(WeixinAccount weixinAccount,
                            AbstractCacheStorager<Token> cacheStorager)
```
    微信接口实现
    
    参数:
    
    weixinAccount - 账号信息
    
    cacheStorager - token管理
  - WeixinMPlatformProxy
```
public WeixinMPlatformProxy(TicketPermanentManager perTicketManager,
                            TokenManager componentTokenManager,
                            String userAuthRedirectUrl,
                            String openUserAuthRedirctUrl)
```
    第三方组件方式创建微信接口实现(永久刷新令牌机制)
    
    参数:
    
    perTicketManager - 第三方组件永久刷新token
    
    componentTokenManager - 第三方组件凭证token
    
    另请参阅:
    
    ComponentProxy, ComponentProxy.getPreCodeManager(), MPlatformProxy.getTokenManager()
- 方法详细资料
  - getWeixinAccount
```
public WeixinAccount getWeixinAccount()
```
    获取微信账号信息
    
    返回:
  - getTokenManager
```
public TokenManager getTokenManager()
```
    token管理
    
    返回:
  - getTicketManager
```
public TokenManager getTicketManager(TicketType ticketType)
```
    获取JSSDK Ticket的tokenManager
    
    参数:
    
    ticketType - 票据类型
    
    返回:
  - getOauthProxy
```
public OauthProxy getOauthProxy()
```
  - getMediaProxy
```
public MediaProxy getMediaProxy()
```
  - getNotifyProxy
```
public NotifyProxy getNotifyProxy()
```
  - getArticleProxy
```
public ArticleProxy getArticleProxy()
```
  - getCardProxy
```
public CardProxy getCardProxy()
```
  - getCustomProxy
```
public CustomProxy getCustomProxy()
```
  - getDataProxy
```
public DataProxy getDataProxy()
```
  - getMenuProxy
```
public MenuProxy getMenuProxy()
```
  - getMessageProxy
```
public MessageProxy getMessageProxy()
```
  - getQrcodeProxy
```
public QrcodeProxy getQrcodeProxy()
```
  - getShakeProxy
```
public ShakeProxy getShakeProxy()
```
  - getTagProxy
```
public TagProxy getTagProxy()
```
  - getTemplateMessageProxy
```
public TemplateMessageProxy getTemplateMessageProxy()
```
  - getUserProxy
```
public UserProxy getUserProxy()
```
  - getToolsProxy
```
public ToolsProxy getToolsProxy()
```
  - uploadImage
```
public String uploadImage(InputStream is,
                          String fileName)
                   throws WeixinException
```
    上传图文消息内的图片获取URL 请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下。
    
    参数:
    
    is - 图片数据流
    
    fileName - 文件名为空时将自动生成
    
    返回:
    
    图片URL 可用于后续群发中，放置到图文消息中
    
    抛出:
    
    WeixinException
  - uploadVideo
```
public MpVideoMessageTuple uploadVideo(InputStream is,
                                       String fileName,
                                       String title,
                                       String description)
                                throws WeixinException
```
    上传群发中的视频素材
    
    参数:
    
    is - 图片数据流
    
    fileName - 文件名为空时将自动生成
    
    title - 视频标题非空
    
    description - 视频描述可为空
    
    返回:
    
    群发视频消息对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    高级群发, MpVideoMessageTuple
  - uploadMedia
```
public MediaUploadResult uploadMedia(boolean isMaterial,
                                     InputStream is,
                                     String fileName)
                              throws WeixinException
```
    上传媒体文件此接口只包含图片、语音、缩略图、视频(临时)四种媒体类型的上传
    
    参数:
    
    isMaterial - 是否永久上传
    
    is - 媒体数据流
    
    fileName - 文件名为空时将自动生成
    
    返回:
    
    上传到微信服务器返回的媒体标识
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    上传临时素材, 上传永久素材, MediaUploadResult, MediaType
  - downloadMedia
```
public MediaDownloadResult downloadMedia(String mediaId,
                                         boolean isMaterial)
                                  throws WeixinException
```
    下载媒体文件
    
    参数:
    
    mediaId - 媒体ID
    
    isMaterial - 是否永久素材
    
    返回:
    
    媒体文件下载结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MediaDownloadResult, 下载临时媒体素材, 下载永久媒体素材
  - uploadMaterialArticle
```
public String uploadMaterialArticle(List<MpArticle> articles)
                             throws WeixinException
```
    上传永久图文素材
    、新增的永久素材也可以在公众平台官网素材管理模块中看到,永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000，其他类型为1000
    
    参数:
    
    articles - 图文列表
    
    返回:
    
    上传到微信服务器返回的媒体标识
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MpArticle, 上传永久媒体素材
  - downloadArticle
```
public List<MpArticle> downloadArticle(String mediaId)
                                throws WeixinException
```
    下载永久图文素材
    
    参数:
    
    mediaId - 媒体ID
    
    返回:
    
    图文列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MpArticle
  - updateMaterialArticle
```
public ApiResult updateMaterialArticle(String mediaId,
                                       int index,
                                       MpArticle article)
                                throws WeixinException
```
    更新永久图文素材
    
    参数:
    
    mediaId - 要修改的图文消息的id
    
    index - 要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
    
    article - 图文对象
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MediaProxy, MpArticle, 更新永久图文素材
  - deleteMaterialMedia
```
public ApiResult deleteMaterialMedia(String mediaId)
                              throws WeixinException
```
    删除永久媒体素材
    
    参数:
    
    mediaId - 媒体素材的media_id
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MediaProxy, 删除永久媒体素材
  - uploadMaterialVideo
```
public String uploadMaterialVideo(InputStream is,
                                  String fileName,
                                  String title,
                                  String introduction)
                           throws WeixinException
```
    上传永久视频素材
    
    参数:
    
    is - 大小不超过1M且格式为MP4的视频文件
    
    fileName - 文件名为空时将自动生成
    
    title - 视频标题
    
    introduction - 视频描述
    
    返回:
    
    上传到微信服务器返回的媒体标识
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    上传永久媒体素材
  - countMaterialMedia
```
public MediaCounter countMaterialMedia()
                                throws WeixinException
```
    获取永久媒体素材的总数 .图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000
    
    返回:
    
    总数对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MediaCounter, 获取素材总数
  - listMaterialMedia
```
public MediaRecord listMaterialMedia(MediaType mediaType,
                                     Pageable pageable)
                              throws WeixinException
```
    获取媒体素材记录列表
    
    参数:
    
    mediaType - 素材的类型，图片（image）、视频（video）、语音（voice）、图文（news）
    
    pageable - 分页数据
    
    返回:
    
    媒体素材的记录对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MediaRecord, MediaType, MediaItem, Pageable, PageData, 获取素材列表
  - listAllMaterialMedia
```
public List<MediaItem> listAllMaterialMedia(MediaType mediaType)
                                     throws WeixinException
```
    获取全部的媒体素材
    
    参数:
    
    mediaType - 媒体类型
    
    返回:
    
    素材列表
    
    抛出:
    
    WeixinException
  - sendNotify
```
public ApiResult sendNotify(NotifyMessage notify)
                     throws WeixinException
```
    发送客服消息(在48小时内不限制发送次数)
    
    参数:
    
    notify - 客服消息对象
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
  - sendNotify
```
public ApiResult sendNotify(NotifyMessage notify,
                            String kfAccount)
                     throws WeixinException
```
    发送客服消息(在48小时内不限制发送次数)
    
    参数:
    
    notify - 客服消息对象
    
    kfAccount - 客服账号可为空
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    发送客服消息, TextMessageTuple, ImageMessageTuple, VoiceMessageTuple, VideoMessageTuple, MusicMessageTuple, NewsMessageTuple, NotifyProxy
  - getCustomChatRecord
```
public List<CustomChatRecord> getCustomChatRecord(Date startTime,
                                                  Date endTime,
                                                  int number)
                                           throws WeixinException
```
    客服聊天记录
    
    参数:
    
    startTime - 查询开始时间
    
    endTime - 查询结束时间每次查询不能跨日查询
    
    number - 最多10000条
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomChatRecord, CustomProxy, 查询客服聊天记录, 查询客服聊天记录
  - listCustomAccount
```
public List<CustomAccount> listCustomAccount()
                                      throws WeixinException
```
    获取公众号中所设置的客服基本信息，包括客服工号、客服昵称、客服登录账号
    
    返回:
    
    多客服信息列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomAccount, CustomProxy, 获取客服基本信息
  - listOnlineCustomAccount
```
public List<CustomOnlineAccount> listOnlineCustomAccount()
                                                  throws WeixinException
```
    获取在线客服在线状态（手机在线、PC客户端在线、手机和PC客户端全都在线）、客服自动接入最大值、客服当前接待客户数
    
    返回:
    
    多客服在线信息列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomOnlineAccount, CustomProxy, 获取客服在线信息
  - createCustomAccount
```
public ApiResult createCustomAccount(String id,
                                     String name)
                              throws WeixinException
```
    新增客服账号
    
    参数:
    
    id - 完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。如果没有公众号微信号，请前往微信公众平台设置。
    
    name - 客服昵称，最长6个汉字或12个英文字符
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    客服管理接口返回码
  - updateCustomAccount
```
public ApiResult updateCustomAccount(String id,
                                     String name)
                              throws WeixinException
```
    更新客服账号
    
    参数:
    
    id - 完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。如果没有公众号微信号，请前往微信公众平台设置。
    
    name - 客服昵称，最长6个汉字或12个英文字符
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, 更新客服账号
  - inviteKfAccount
```
public ApiResult inviteKfAccount(String kfAccount,
                                 String inviteAccount)
                          throws WeixinException
```
    邀请绑定客服帐号新添加的客服帐号是不能直接使用的，只有客服人员用微信号绑定了客服账号后，方可登录Web客服进行操作。此接口发起一个绑定邀请到客服人员微信号，客服人员需要在微信客户端上用该微信号确认后帐号才可用。尚未绑定微信号的帐号可以进行绑定邀请操作，邀请未失效时不能对该帐号进行再次绑定微信号邀请。
    
    参数:
    
    kfAccount - 完整客服帐号，格式为：帐号前缀@公众号微信号
    
    inviteAccount - 接收绑定邀请的客服微信号
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
  - uploadCustomAvatar
```
public ApiResult uploadCustomAvatar(String accountId,
                                    InputStream is,
                                    String fileName)
                             throws WeixinException
```
    上传客服头像
    
    参数:
    
    accountId - 完整客服账号，格式为：账号前缀@公众号微信号
    
    is - 头像图片文件必须是jpg格式，推荐使用640*640大小的图片以达到最佳效果
    
    fileName - 文件名为空时将自动生成
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, 上传客服头像
  - deleteCustomAccount
```
public ApiResult deleteCustomAccount(String id)
                              throws WeixinException
```
    删除客服账号
    
    参数:
    
    id - 完整客服账号，格式为：账号前缀@公众号微信号
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, 删除客服账号
  - createCustomSession
```
public ApiResult createCustomSession(String userOpenId,
                                     String kfAccount,
                                     String text)
                              throws WeixinException
```
    创建客服会话
    开发者可以使用本接口，为多客服的客服工号创建会话，将某个客户直接指定给客服工号接待，需要注意此接口不会受客服自动接入数以及自动接入开关限制。只能为在线的客服（PC客户端在线，或者已绑定多客服助手）创建会话。
    
    参数:
    
    userOpenId - 用户的userOpenId
    
    kfAccount - 完整客服账号，格式为：账号前缀@公众号微信号
    
    text - 附加信息，文本会展示在客服人员的多客服客户端
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, 创建会话
  - closeCustomSession
```
public ApiResult closeCustomSession(String userOpenId,
                                    String kfAccount,
                                    String text)
                             throws WeixinException
```
    关闭客服会话
    
    参数:
    
    userOpenId - 用户的userOpenId
    
    kfAccount - 完整客服账号，格式为：账号前缀@公众号微信号
    
    text - 附加信息，文本会展示在客服人员的多客服客户端
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, 关闭会话
  - getCustomSession
```
public CustomChatSession getCustomSession(String userOpenId)
                                   throws WeixinException
```
    获取客户的会话状态:获取客户当前的会话状态。
    
    参数:
    
    userOpenId - 用户的openid
    
    返回:
    
    会话对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, CustomChatSession, 获取会话状态
  - listCustomSession
```
public List<CustomChatSession> listCustomSession(String kfAccount)
                                          throws WeixinException
```
    获取客服的会话列表:获取某个客服正在接待的会话列表。
    
    参数:
    
    kfAccount - 完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。
    
    返回:
    
    会话列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, CustomChatSession, 获取客服的会话列表
  - listCustomWaitSession
```
public CustomChatSession.CustomChatSessionCounter listCustomWaitSession()
                                                                 throws WeixinException
```
    获取未接入会话列表:获取当前正在等待队列中的会话列表，此接口最多返回最早进入队列的100个未接入会话
    
    返回:
    
    会话列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    CustomProxy, CustomChatSession, CustomChatSession.CustomChatSessionCounter, 获取客服的会话列表
  - uploadMessageArticle
```
public String uploadMessageArticle(List<MpArticle> articles)
                            throws WeixinException
```
    上传群发的图文消息,一个图文消息支持1到10条图文
    
    参数:
    
    articles - 图片消息
    
    返回:
    
    媒体ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    上传图文素材, MpArticle, MessageProxy
  - messageByGroupId
```
public String[] messageByGroupId(MultiMessageTuple tuple,
                                 boolean isToAll,
                                 int groupId)
                          throws WeixinException
```
    群发消息
    在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息, 如消息有时会进行审核、服务器不稳定等,此外,群发任务一般需要较长的时间才能全部发送完毕
    
    参数:
    
    tuple - 消息元件
    
    isToAll - 用于设定是否向全部用户发送，值为true或false，选择true该消息群发给所有用户，选择false可根据group_id发送给指定群组的用户
    
    groupId - 分组ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TextMessageTuple, ImageMessageTuple, VoiceMessageTuple, VideoMessageTuple, MpNewsMessageTuple, MessageProxy, MultiMessageTuple, 根据分组群发
  - messageArticleByGroupId
```
public String[] messageArticleByGroupId(List<MpArticle> articles,
                                        int groupId)
                                 throws WeixinException
```
    分组ID群发图文消息
    
    参数:
    
    articles - 图文列表
    
    groupId - 分组ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据分组群发, MpArticle
  - messageToAll
```
public String[] messageToAll(MultiMessageTuple tuple)
                      throws WeixinException
```
    群发消息给所有粉丝
    
    参数:
    
    tuple - 消息元件
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MessageProxy, 根据标签群发
  - messageByTagId
```
public String[] messageByTagId(MultiMessageTuple tuple,
                               int tagId)
                        throws WeixinException
```
    标签群发消息
    
    参数:
    
    tuple - 消息元件
    
    tagId - 标签ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    Tag, MessageProxy, 根据标签群发
  - messageArticleByTagId
```
public String[] messageArticleByTagId(List<MpArticle> articles,
                                      int tagId,
                                      boolean ignoreReprint)
                               throws WeixinException
```
    标签群发图文消息
    
    参数:
    
    articles - 图文列表
    
    tagId - 标签ID
    
    ignoreReprint - 图文消息被判定为转载时，是否继续群发
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现。
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据标签群发, MpArticle, MessageProxy
  - messageByOpenIds
```
public String[] messageByOpenIds(MultiMessageTuple tuple,
                                 String... openIds)
                          throws WeixinException
```
    openId群发消息
    
    参数:
    
    tuple - 消息元件
    
    openIds - openId列表
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据openid群发, MessageProxy
  - messageArticleByOpenIds
```
public String[] messageArticleByOpenIds(List<MpArticle> articles,
                                        boolean ignoreReprint,
                                        String... openIds)
                                 throws WeixinException
```
    openid群发图文消息
    
    参数:
    
    articles - 图文列表
    
    ignoreReprint - 图文消息被判定为转载时，是否继续群发
    
    openIds - openId列表
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中.
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据openid群发, MpArticle, MessageProxy
  - deleteMessageNews
```
public ApiResult deleteMessageNews(String msgid)
                            throws WeixinException
```
    删除群发消息
    
    参数:
    
    msgid - 发送出去的消息ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除群发, deleteMessageNews(String), MessageProxy
  - deleteMessageNews
```
public ApiResult deleteMessageNews(String msgid,
                                   int articleIndex)
                            throws WeixinException
```
    删除群发消息
    请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片
    
    参数:
    
    msgid - 发送出去的消息ID
    
    articleIndex - 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除群发, MessageProxy
  - previewMessageNews
```
public ApiResult previewMessageNews(String toUser,
                                    String toWxName,
                                    MultiMessageTuple tuple)
                             throws WeixinException
```
    预览群发消息开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版
    
    参数:
    
    toUser - 接收用户的openID
    
    toWxName - 接收用户的微信号 towxname和touser同时赋值时，以towxname优先
    
    tuple - 消息元件
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MessageProxy, MultiMessageTuple, 预览群发消息
  - getMessageNewStatus
```
public String getMessageNewStatus(String msgId)
                           throws WeixinException
```
    查询群发发送状态
    
    参数:
    
    msgId - 消息ID
    
    返回:
    
    消息发送状态
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MessageProxy, 查询群发状态
  - getUser
```
public User getUser(String openId)
             throws WeixinException
```
    获取用户信息
    
    参数:
    
    openId - 用户对应的ID
    
    返回:
    
    用户对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取用户信息, User, UserProxy
  - getUser
```
public User getUser(String openId,
                    Lang lang)
             throws WeixinException
```
    获取用户信息
    在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID（加密后的微信号,每个用户对每个公众号的OpenID是唯一的,对于不同公众号, 同一用户的openid不同）,公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间
    
    参数:
    
    openId - 用户对应的ID
    
    lang - 国家地区语言版本
    
    返回:
    
    用户对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取用户信息, Lang, User, UserProxy
  - getUsers
```
public List<User> getUsers(String... openIds)
                    throws WeixinException
```
    批量获取用户信息
    
    参数:
    
    openIds - 用户ID
    
    返回:
    
    用户列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取用户信息, User, UserProxy
  - getUsers
```
public List<User> getUsers(Lang lang,
                           String... openIds)
                    throws WeixinException
```
    批量获取用户信息
    
    参数:
    
    lang - 国家地区语言版本
    
    openIds - 用户ID
    
    返回:
    
    用户列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取用户信息, Lang, User, UserProxy
  - getFollowing
```
public Following getFollowing(String nextOpenId)
                       throws WeixinException
```
    获取公众号一定数量(10000)的关注者列表请慎重使用
    
    参数:
    
    nextOpenId - 下一次拉取数据的openid 不填写则默认从头开始拉取
    
    返回:
    
    关注者信息包含用户的详细信息
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取关注者列表, 批量获取用户信息, UserProxy, Following, User
  - getFollowingOpenIds
```
public Following getFollowingOpenIds(String nextOpenId)
                              throws WeixinException
```
    获取公众号一定数量(10000)的关注者列表
    
    参数:
    
    nextOpenId - 下一次拉取数据的openid 不填写则默认从头开始拉取
    
    返回:
    
    关注者信息不包含用户的详细信息
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取关注者列表, UserProxy, Following
  - getAllFollowing
```
public List<User> getAllFollowing()
                           throws WeixinException
```
    获取公众号全部的关注者列表请慎重使用
    当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
    
    返回:
    
    用户对象集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取关注者列表, 批量获取用户信息, UserProxy, Following, User, getFollowing(String)
  - getAllFollowingOpenIds
```
public List<String> getAllFollowingOpenIds()
                                    throws WeixinException
```
    获取公众号全部的关注者列表请慎重使用
    当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
    
    返回:
    
    用户openid集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取关注者列表, UserProxy, getFollowingOpenIds(String)
  - remarkUserName
```
public ApiResult remarkUserName(String openId,
                                String remark)
                         throws WeixinException
```
    设置用户备注名
    
    参数:
    
    openId - 用户ID
    
    remark - 备注名
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    设置用户备注名, UserProxy
  - createMenu
```
public ApiResult createMenu(List<Button> buttons)
                     throws WeixinException
```
    自定义菜单
    
    参数:
    
    buttons - 菜单列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    创建自定义菜单, Button, ButtonType
  - getMenu
```
public List<Button> getMenu()
                     throws WeixinException
```
    查询菜单
    
    返回:
    
    菜单集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    查询菜单, Button
  - getAllMenu
```
public List<Menu> getAllMenu()
                      throws WeixinException
```
    查询全部菜单(包含个性化菜单)
    
    返回:
    
    菜单集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    普通菜单, 个性化菜单, Button, Menu
  - deleteMenu
```
public ApiResult deleteMenu()
                     throws WeixinException
```
    删除菜单
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除菜单
  - createCustomMenu
```
public String createCustomMenu(List<Button> buttons,
                               MenuMatchRule matchRule)
                        throws WeixinException
```
    创建个性化菜单
    
    参数:
    
    buttons - 菜单列表
    
    matchRule - 匹配规则至少要有一个匹配信息是不为空
    
    返回:
    
    菜单ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    创建个性化菜单, Button
  - deleteCustomMenu
```
public ApiResult deleteCustomMenu(String menuId)
                           throws WeixinException
```
    删除个性化菜单
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除个性化菜单
  - matchCustomMenu
```
public List<Button> matchCustomMenu(String userId)
                             throws WeixinException
```
    测试个性化菜单匹配结果
    
    参数:
    
    userId - 可以是粉丝的OpenID，也可以是粉丝的微信号。
    
    返回:
    
    匹配到的菜单配置
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    测试个性化菜单, Button
  - createQrcode
```
public QrcodeResult createQrcode(QrcodeParameter parameter)
                          throws WeixinException
```
    生成带参数的二维码
    
    参数:
    
    parameter - 二维码参数
    
    返回:
    
    二维码结果对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    QrcodeResult, QrcodeParameter, QrcodeProxy, 生成二维码
  - setTmplIndustry
```
public ApiResult setTmplIndustry(IndustryType... industryTypes)
                          throws WeixinException
```
    设置所属行业(每月可修改行业1次，账号仅可使用所属行业中相关的模板)
    
    参数:
    
    industryTypes - 所处行业目前不超过两个
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    IndustryType, TemplateMessageProxy, 设置所处行业
  - getTemplateId
```
public String getTemplateId(String shortId)
                     throws WeixinException
```
    获取模板ID
    
    参数:
    
    shortId - 模板库中模板的编号，有“TM**”和“OPENTMTM**”等形式
    
    返回:
    
    模板ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获得模板ID, TemplateMessageProxy
  - getAllTemplates
```
public List<TemplateMessageInfo> getAllTemplates()
                                          throws WeixinException
```
    获取模板列表
    
    返回:
    
    模板列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TemplateMessageInfo, 获取模板列表, TemplateMessageProxy
  - deleteTemplate
```
public ApiResult deleteTemplate(String templateId)
                         throws WeixinException
```
    删除模板
    
    参数:
    
    templateId - 公众帐号下模板消息ID
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除模板, TemplateMessageProxy
  - sendTmplMessage
```
public String sendTmplMessage(TemplateMessage tplMessage)
                       throws WeixinException
```
    发送模板消息
    
    参数:
    
    tplMessage - 模板消息主体
    
    返回:
    
    发送的消息ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    模板消息, 运营规范, TemplateMessage, TemplateMessageProxy
  - getShorturl
```
public String getShorturl(String url)
                   throws WeixinException
```
    长链接转短链接
    
    参数:
    
    url - 待转换的链接
    
    返回:
    
    短链接
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    长链接转短链接, ToolsProxy
  - semantic
```
public SemResult semantic(SemQuery semQuery)
                   throws WeixinException
```
    语义理解
    
    参数:
    
    semQuery - 语义理解协议
    
    返回:
    
    语义理解结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    SemQuery, SemResult, 语义理解, ToolsProxy
  - getWechatServerIp
```
public List<String> getWechatServerIp()
                               throws WeixinException
```
    获取微信服务器IP地址
    
    返回:
    
    IP地址
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取IP地址, ToolsProxy
  - clearQuota
```
public ApiResult clearQuota()
                     throws WeixinException
```
    接口调用次数调用清零：公众号调用接口并不是无限制的。为了防止公众号的程序错误而引发微信服务器负载异常，默认情况下，每个公众号调用接口都不能超过一定限制，当超过一定限制时，调用对应接口会收到{"errcode":45009,"errmsg":"api freq out of limit" }错误返回码。
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    接口清零, ToolsProxy
  - getMenuSetting
```
public MenuSetting getMenuSetting()
                           throws WeixinException
```
    获取公众号当前使用的自定义菜单的配置，如果公众号是通过API调用设置的菜单，则返回菜单的开发配置，而如果公众号是在公众平台官网通过网站功能发布菜单，则本接口返回运营者设置的菜单配置。
    
    返回:
    
    菜单集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取自定义菜单配置, Button, MpArticle, ToolsProxy
  - getAutoReplySetting
```
public AutoReplySetting getAutoReplySetting()
                                     throws WeixinException
```
    获取公众号当前使用的自动回复规则，包括关注后自动回复、消息自动回复（60分钟内触发一次）、关键词自动回复。
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    AutoReplySetting, ToolsProxy, 获取自动回复规则
  - datacube
```
public List<?> datacube(DatacubeType datacubeType,
                        Date beginDate,
                        Date endDate)
                 throws WeixinException
```
    数据统计
    
    参数:
    
    datacubeType - 数据统计类型
    
    beginDate - 获取数据的起始日期，begin_date和end_date的差值需小于“最大时间跨度”（比如最大时间跨度为1时， begin_date和end_date的差值只能为0，才能小于1），否则会报错
    
    endDate - 获取数据的结束日期，end_date允许设置的最大值为昨日
    
    返回:
    
    统计结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    DataProxy, UserSummary, ArticleSummary, ArticleTotal, ArticleDatacubeShare, UpstreamMessage, UpstreamMessageDist, InterfaceSummary, 用户分析, 图文分析, 消息分析, 接口分析
  - datacube
```
public List<?> datacube(DatacubeType datacubeType,
                        Date beginDate,
                        int offset)
                 throws WeixinException
```
    数据统计
    
    参数:
    
    datacubeType - 统计类型
    
    beginDate - 开始日期
    
    offset - 增量表示向前几天比如 offset=1 则查询 beginDate的后一天之间的数据
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    DataProxy
  - datacube
```
public List<?> datacube(DatacubeType datacubeType,
                        int offset,
                        Date endDate)
                 throws WeixinException
```
    数据统计
    
    参数:
    
    datacubeType - 统计类型
    
    offset - 增量表示向后几天比如 offset=1 则查询 beginDate的前一天之间的数据
    
    endDate - 截至日期
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    DataProxy
  - datacube
```
public List<?> datacube(DatacubeType datacubeType,
                        Date date)
                 throws WeixinException
```
    查询日期跨度为0的统计数据(当天)
    
    参数:
    
    datacubeType - 统计类型
    
    date - 统计日期
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    DataProxy
  - createTag
```
public Tag createTag(String name)
              throws WeixinException
```
    创建标签
    
    参数:
    
    name - 标签名（30个字符以内）
    
    返回:
    
    标签对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, Tag, 创建标签
  - listTags
```
public List<Tag> listTags()
                   throws WeixinException
```
    获取标签
    
    返回:
    
    标签列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, Tag, 获取标签
  - updateTag
```
public ApiResult updateTag(Tag tag)
                    throws WeixinException
```
    更新标签
    
    参数:
    
    tag - 标签对象
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, Tag, 更新标签
  - deleteTag
```
public ApiResult deleteTag(int tagId)
                    throws WeixinException
```
    删除标签
    
    参数:
    
    tagId - 标签id
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 删除标签
  - taggingUsers
```
public ApiResult taggingUsers(int tagId,
                              String... openIds)
                       throws WeixinException
```
    批量为用户打标签:标签功能目前支持公众号为用户打上最多三个标签
    
    参数:
    
    tagId - 标签ID
    
    openIds - 用户ID
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 批量为用户打标签
  - untaggingUsers
```
public ApiResult untaggingUsers(int tagId,
                                String... openIds)
                         throws WeixinException
```
    批量为用户取消标签
    
    参数:
    
    tagId - 标签ID
    
    openIds - 用户ID
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 批量为用户取消标签
  - getTagFollowingOpenIds
```
public Following getTagFollowingOpenIds(int tagId,
                                        String nextOpenId)
                                 throws WeixinException
```
    获取标签下粉丝列表
    
    参数:
    
    tagId - 标签ID
    
    nextOpenId - 第一个拉取的OPENID，不填默认从头开始拉取
    
    返回:
    
    用户openid列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 获取标签下粉丝列表
  - getTagFollowing
```
public Following getTagFollowing(int tagId,
                                 String nextOpenId)
                          throws WeixinException
```
    获取标签下粉丝列表请慎重使用
    
    参数:
    
    tagId - 标签ID
    
    nextOpenId - 第一个拉取的OPENID，不填默认从头开始拉取
    
    返回:
    
    被打标签者信息包含用户的详细信息
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 获取标签下粉丝列表
  - getAllTagFollowingOpenIds
```
public List<String> getAllTagFollowingOpenIds(int tagId)
                                       throws WeixinException
```
    获取标签下全部的粉丝列表请慎重使用
    
    参数:
    
    tagId - 标签ID
    
    返回:
    
    用户openid列表
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, getTagFollowingOpenIds(int,String), 获取标签下粉丝列表
  - getAllTagFollowing
```
public List<User> getAllTagFollowing(int tagId)
                              throws WeixinException
```
    获取标签下全部的粉丝列表请慎重使用
    
    参数:
    
    tagId - 标签ID
    
    返回:
    
    被打标签者信息包含用户的详细信息
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, getTagFollowing(int,String), 获取标签下粉丝列表
  - getUserTags
```
public Integer[] getUserTags(String openId)
                      throws WeixinException
```
    获取用户身上的标签列表
    
    参数:
    
    openId - 用户ID
    
    返回:
    
    标签ID集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 获取用户身上的标签列表
  - getBalcklistOpenIds
```
public Following getBalcklistOpenIds(String nextOpenId)
                              throws WeixinException
```
    获取公众号的黑名单列表
    
    参数:
    
    nextOpenId - 下一次拉取数据的openid 不填写则默认从头开始拉取
    
    返回:
    
    拉黑用户列表不包含用户的详细信息
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    获取黑名单列表, TagProxy, Following
  - getAllBalcklistOpenIds
```
public List<String> getAllBalcklistOpenIds()
                                    throws WeixinException
```
    获取公众号全部的黑名单列表请慎重使用
    当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求, 将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值
    
    返回:
    
    用户openid集合
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 获取黑名单列表, getFollowingOpenIds(String)
  - batchBlacklist
```
public ApiResult batchBlacklist(boolean blacklist,
                                String... openIds)
                         throws WeixinException
```
    黑名单操作
    
    参数:
    
    blacklist - true=拉黑用户,false=取消拉黑用户
    
    openIds - 用户ID列表
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TagProxy, 黑名单操作
  - createCardCoupon
```
public String createCardCoupon(CardCoupon cardCoupon)
                        throws WeixinException
```
    创建卡券:创建卡券接口是微信卡券的基础接口，用于创建一类新的卡券，获取card_id，创建成功并通过审核后，商家可以通过文档提供的其他接口将卡券下发给用户，每次成功领取，库存数量相应扣除。 1.需自定义Code码的商家必须在创建卡券时候，设定use_custom_code为true，且在调用投放卡券接口时填入指定的Code码。指定OpenID同理。特别注意：在公众平台创建的卡券均为非自定义Code类型。 2.can_share字段指领取卡券原生页面是否可分享，建议指定Code码、指定OpenID等强限制条件的卡券填写false。 3.创建成功后该卡券会自动提交审核，审核结果将通过事件通知商户。开发者可调用设置白名单接口设置用户白名单，领取未通过审核的卡券，测试整个卡券的使用流程。
    
    参数:
    
    cardCoupon - 卡券对象
    
    返回:
    
    卡券ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    创建卡券, CardCoupons, MediaProxy.uploadImage(java.io.InputStream, String), CardProxy
  - setCardPayCell
```
public ApiResult setCardPayCell(String cardId,
                                boolean isOpen)
                         throws WeixinException
```
    设置卡券买单：创建卡券之后，开发者可以通过设置微信买单接口设置该card_id支持微信买单功能。值得开发者注意的是，设置买单的card_id必须已经配置了门店，否则会报错。
    
    参数:
    
    cardId - 卡券ID
    
    isOpen - 是否开启买单功能，填true/false
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    createCardCoupon(CardCoupon), CardProxy
  - setCardSelfConsumeCell
```
public ApiResult setCardSelfConsumeCell(String cardId,
                                        boolean isOpen)
                                 throws WeixinException
```
    设置自助核销:创建卡券之后，开发者可以通过设置微信买单接口设置该card_id支持自助核销功能。值得开发者注意的是，设置自助核销的card_id必须已经配置了门店，否则会报错。
    
    参数:
    
    cardId - 卡券ID
    
    isOpen - 是否开启买单功能，填true/false
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    createCardCoupon(CardCoupon), CardProxy
  - createCardQR
```
public QrcodeResult createCardQR(Integer expireSeconds,
                                 CardQR... cardQRs)
                          throws WeixinException
```
    创建卡券二维码：开发者可调用该接口生成一张卡券二维码供用户扫码后添加卡券到卡包。
    
    参数:
    
    expireSeconds - 指定二维码的有效时间，范围是60 ~ 1800秒。不填默认为365天有效
    
    cardQRs - 二维码参数:二维码领取单张卡券/多张卡券
    
    返回:
    
    二维码结果对象
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    QrcodeResult, QrcodeParameter, CardProxy, 投放卡券
  - openComment
```
public ApiResult openComment(boolean open,
                             String msgid,
                             int index)
                      throws WeixinException
```
    打开/关闭已群发文章评论
    
    参数:
    
    open - true为打开，false为关闭
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ComponentProxy
  - listArticleComments
```
public PageData<ArticleComment> listArticleComments(Pageable page,
                                                    ArticleComment.ArticleCommentType commentType,
                                                    String msgid,
                                                    int index)
                                             throws WeixinException
```
    获取评论列表
    
    参数:
    
    page - 分页信息
    
    commentType - 评论类型为空获取全部类型
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    返回:
    
    分页数据
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleComment, ArticleComment.ArticleCommentType, ArticleProxy
  - listAllArticleComments
```
public List<ArticleComment> listAllArticleComments(ArticleComment.ArticleCommentType commentType,
                                                   String msgid,
                                                   int index)
                                            throws WeixinException
```
    获取评论列表
    
    参数:
    
    commentType - 评论类型为空获取全部类型
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    返回:
    
    分页数据
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleProxy, listArticleComments(Pageable, ArticleComment.ArticleCommentType, String, int)
  - markelectComment
```
public ApiResult markelectComment(boolean markelect,
                                  String msgid,
                                  int index,
                                  String commentId)
                           throws WeixinException
```
    评论标记/取消精选
    
    参数:
    
    markelect - true为标记，false为取消
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    commentId - 用户评论ID
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleProxy, listArticleComments(Pageable, ArticleComment.ArticleCommentType, String, int)
  - deleteComment
```
public ApiResult deleteComment(String msgid,
                               int index,
                               String commentId)
                        throws WeixinException
```
    删除评论
    
    参数:
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    commentId - 用户评论ID
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleProxy, listArticleComments(Pageable, ArticleComment.ArticleCommentType, String, int)
  - replyComment
```
public ApiResult replyComment(String msgid,
                              int index,
                              String commentId,
                              String content)
                       throws WeixinException
```
    回复评论
    
    参数:
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    commentId - 用户评论ID
    
    content - 回复内容
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleProxy, listArticleComments(Pageable, ArticleComment.ArticleCommentType, String, int)
  - deleteCommentReply
```
public ApiResult deleteCommentReply(String msgid,
                                    int index,
                                    String commentId)
                             throws WeixinException
```
    删除回复
    
    参数:
    
    msgid - 群发返回的msg_data_id
    
    index - 多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
    
    commentId - 用户评论ID
    
    返回:
    
    操作结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    ArticleProxy, listArticleComments(Pageable, ArticleComment.ArticleCommentType, String, int)

类 WeixinMPlatformProxy

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

WeixinMPlatformProxy

WeixinMPlatformProxy

方法详细资料

getWeixinAccount

getTokenManager

getTicketManager

getOauthProxy

getMediaProxy

getNotifyProxy

getArticleProxy

getCardProxy

getCustomProxy

getDataProxy

getMenuProxy

getMessageProxy

getQrcodeProxy

getShakeProxy

getTagProxy

getTemplateMessageProxy

getUserProxy

getToolsProxy

uploadImage

uploadVideo

uploadMedia

downloadMedia

uploadMaterialArticle

downloadArticle

updateMaterialArticle

deleteMaterialMedia

uploadMaterialVideo

countMaterialMedia

listMaterialMedia

listAllMaterialMedia

sendNotify

sendNotify

getCustomChatRecord

listCustomAccount

listOnlineCustomAccount

createCustomAccount

updateCustomAccount

inviteKfAccount

uploadCustomAvatar

deleteCustomAccount

createCustomSession

closeCustomSession

getCustomSession

listCustomSession

listCustomWaitSession

uploadMessageArticle

messageByGroupId

messageArticleByGroupId

messageToAll

messageByTagId

messageArticleByTagId

messageByOpenIds

messageArticleByOpenIds

deleteMessageNews

deleteMessageNews

previewMessageNews

getMessageNewStatus

getUser

getUser

getUsers

getUsers

getFollowing

getFollowingOpenIds

getAllFollowing

getAllFollowingOpenIds

remarkUserName

createMenu

getMenu

getAllMenu

deleteMenu

createCustomMenu

deleteCustomMenu