me.chanjar.weixin.mp.api.impl

类 WxMpMassMessageServiceImpl

java.lang.Object

me.chanjar.weixin.mp.api.impl.WxMpMassMessageServiceImpl

所有已实现的接口:

WxMpMassMessageService

public class WxMpMassMessageServiceImpl
extends Object
implements WxMpMassMessageService

 群发消息服务类
 Created by Binary Wang on 2017-8-16.
 

作者:

Binary Wang

构造器概要

构造器

构造器和说明
WxMpMassMessageServiceImpl()

方法概要

限定符和类型	方法和说明
void	delete(Long msgId, Integer articleIndex) 删除群发 群发之后，随时可以通过该接口删除群发。
WxMpMassSendResult	massGroupMessageSend(WxMpMassTagMessage message) 分组群发消息 如果发送图文消息，必须先使用 WxMpMassMessageService.massNewsUpload(WxMpMassNews) 获得media_id，然后再发送 如果发送视频消息，必须先使用 WxMpMassMessageService.massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
WxMpMassSendResult	massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage) 群发消息预览接口 开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。
WxMpMassUploadResult	massNewsUpload(WxMpMassNews news) 上传群发用的图文消息，上传后才能群发图文消息
WxMpMassSendResult	massOpenIdsMessageSend(WxMpMassOpenIdsMessage message) 按openId列表群发消息 如果发送图文消息，必须先使用 WxMpMassMessageService.massNewsUpload(WxMpMassNews) 获得media_id，然后再发送 如果发送视频消息，必须先使用 WxMpMassMessageService.massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
WxMpMassUploadResult	massVideoUpload(WxMpMassVideo video) 上传群发用的视频，上传后才能群发视频消息
WxMpMassGetResult	messageMassGet(Long msgId) 查询群发消息发送状态【订阅号与服务号认证后均可用】
WxMpMassSpeedGetResult	messageMassSpeedGet() 获取群发速度
void	messageMassSpeedSet(Integer speed) 设置群发速度

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

WxMpMassMessageServiceImpl

public WxMpMassMessageServiceImpl()

方法详细资料

massNewsUpload

public WxMpMassUploadResult massNewsUpload(WxMpMassNews news)
                                    throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 上传群发用的图文消息，上传后才能群发图文消息
 

指定者:

massNewsUpload 在接口中 WxMpMassMessageService

参数:

news - 图文消息对象

返回:

上传结果对象，包含media_id等信息

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

WxMpMassMessageService.massGroupMessageSend(WxMpMassTagMessage), WxMpMassMessageService.massOpenIdsMessageSend(WxMpMassOpenIdsMessage), 上传群发用的图文消息

massVideoUpload

public WxMpMassUploadResult massVideoUpload(WxMpMassVideo video)
                                     throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 上传群发用的视频，上传后才能群发视频消息
 

指定者:

massVideoUpload 在接口中 WxMpMassMessageService

参数:

video - 视频消息对象

返回:

上传结果对象，包含media_id等信息

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

WxMpMassMessageService.massGroupMessageSend(WxMpMassTagMessage), WxMpMassMessageService.massOpenIdsMessageSend(WxMpMassOpenIdsMessage), 上传群发用的视频

massGroupMessageSend

public WxMpMassSendResult massGroupMessageSend(WxMpMassTagMessage message)
                                        throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 分组群发消息
 如果发送图文消息，必须先使用 WxMpMassMessageService.massNewsUpload(WxMpMassNews) 获得media_id，然后再发送
 如果发送视频消息，必须先使用 WxMpMassMessageService.massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
 

指定者:

massGroupMessageSend 在接口中 WxMpMassMessageService

参数:

message - 分组群发消息对象

返回:

群发结果对象，包含msg_id等信息

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

分组群发消息

massOpenIdsMessageSend

public WxMpMassSendResult massOpenIdsMessageSend(WxMpMassOpenIdsMessage message)
                                          throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 按openId列表群发消息
 如果发送图文消息，必须先使用 WxMpMassMessageService.massNewsUpload(WxMpMassNews) 获得media_id，然后再发送
 如果发送视频消息，必须先使用 WxMpMassMessageService.massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
 

指定者:

massOpenIdsMessageSend 在接口中 WxMpMassMessageService

参数:

message - 按openid列表群发消息对象

返回:

群发结果对象，包含msg_id等信息

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

按openId列表群发消息

massMessagePreview

public WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage)
                                      throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 群发消息预览接口
 开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求，
 在保留对openID预览能力的同时，增加了对指定微信号发送预览的能力，但该能力每日调用次数有限制（100次），请勿滥用。
 

指定者:

massMessagePreview 在接口中 WxMpMassMessageService

参数:

wxMpMassPreviewMessage - 预览消息对象

返回:

群发结果对象，包含msg_id等信息

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

群发消息预览接口

delete

public void delete(Long msgId,
                   Integer articleIndex)
            throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 删除群发
 群发之后，随时可以通过该接口删除群发。
 请注意：
 1、只有已经发送成功的消息才能删除
 2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。
 3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。
 4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效
 

指定者:

delete 在接口中 WxMpMassMessageService

参数:

msgId - 发送出去的消息ID

articleIndex - 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

删除群发

messageMassSpeedGet

public WxMpMassSpeedGetResult messageMassSpeedGet()
                                           throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 获取群发速度
 

指定者:

messageMassSpeedGet 在接口中 WxMpMassMessageService

返回:

群发速度获取结果对象

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

获取群发速度

messageMassSpeedSet

public void messageMassSpeedSet(Integer speed)
                         throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 设置群发速度
 

指定者:

messageMassSpeedSet 在接口中 WxMpMassMessageService

参数:

speed - 群发速度的级别，是一个0到4的整数，数字越大表示群发速度越慢。 speed realspeed 0 80w/分钟 1 60w/分钟 2 45w/分钟 3 30w/分钟 4 10w/分钟

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

设置群发速度

messageMassGet

public WxMpMassGetResult messageMassGet(Long msgId)
                                 throws WxErrorException

从接口复制的说明: WxMpMassMessageService

 查询群发消息发送状态【订阅号与服务号认证后均可用】
 

指定者:

messageMassGet 在接口中 WxMpMassMessageService

参数:

msgId - 群发消息后返回的消息id

返回:

消息发送后的状态，SEND_SUCCESS表示发送成功，SENDING表示发送中，SEND_FAIL表示发送失败，DELETE表示已删除

抛出:

WxErrorException - 微信API调用异常，可能包括：

• 40001 - 获取access_token时AppSecret错误，或者access_token无效
• 40002 - 请确保grant_type字段值为client_credential
• 40003 - appid对应公众号请开发者使用绑定的公众号测试
• 40004 - appid不正确
• 40006 - access_token超时
• 48001 - api功能未授权
• 45009 - 调用接口的QPS超限
• 其他业务错误码

另请参阅:

查询群发消息发送状态