[升级说明] Senparc.Weixin.MP v14.8.11 （微信群发接口调整）

升级内容：添加根据标签群发接口，重构原根据分组群发接口

参考微信文档：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1481187827_i0l21

说明：

之前 SDK 只提供了根据用户组群发的方法：

GroupMessageApi.SendGroupMessageByGroupId();

由于根据分组和标签群发两种情况，逻辑基本一致，只有一个filter参数不同，因此我们创建了 BaseGroupMessageDataByFilter 基类，用于支持 GroupMessageByGroupId 和 GroupMessageByTagId。

BaseGroupMessageByFilter 代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Senparc.Weixin.MP.AdvancedAPIs.GroupMessage
{
/// <summary>
/// 根据筛选条件（GroupId、TagId）群发消息数据的基类
/// </summary>
public abstract class BaseGroupMessageByFilter
{
public bool is_to_all { get; set; }
}

public class BaseGroupMessageDataByFilter
{
public BaseGroupMessageByFilter filter { get; set; }

public string msgtype { get; set; }

/// <summary>
/// 群发接口新增 send_ignore_reprint 参数，开发者可以对群发接口的 send_ignore_reprint 参数进行设置，指定待群发的文章被判定为转载时，是否继续群发。
/// 当 send_ignore_reprint 参数设置为1时，文章被判定为转载时，且原创文允许转载时，将继续进行群发操作。
/// 当 send_ignore_reprint 参数设置为0时，文章被判定为转载时，将停止群发操作。
/// send_ignore_reprint 默认为0。
/// </summary>
public int send_ignore_reprint { get; set; }
}

public class GroupMessageByFilter_MediaId
{
public string media_id { get; set; }
}

public class GroupMessageByFilter_Content
{
public string content { get; set; }
}

public class GroupMessageByFilter_WxCard
{
public string card_id { get; set; }
}

public class GroupMessageByFilter_VoiceData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_MediaId voice { get; set; }
}

public class GroupMessageByFilter_ImageData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_MediaId image { get; set; }
}

public class GroupMessageByFilter_TextData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_Content text { get; set; }
}

public class GroupMessageByFilter_MpNewsData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_MediaId mpnews { get; set; }
}

public class GroupMessageByFilter_MpVideoData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_MediaId mpvideo { get; set; }
}

public class GroupMessageByFilter_WxCardData : BaseGroupMessageDataByFilter
{
public GroupMessageByGroupId_WxCard wxcard { get; set; }
}
}

GroupMessageByTagId 代码如下：

namespace Senparc.Weixin.MP.AdvancedAPIs.GroupMessage
{
/// <summary>
/// 根据 TagId 群发筛选
/// </summary>
public class GroupMessageByTagId : BaseGroupMessageByFilter
{
public string tag_id { get; set; }
}
}

GroupMessageByGroupId 代码如下（包含已经弃用的代码），为了保障向下兼容性，标记了[Obsolete]特性：

namespace Senparc.Weixin.MP.AdvancedAPIs.GroupMessage
{
/// <summary>
/// 根据GroupId群发筛选
/// </summary>
public class GroupMessageByGroupId : BaseGroupMessageByFilter
{
public string group_id { get; set; }
}

#region 已废弃

[Obsolete("请使用GroupMessageByGroupId")]
public class GroupMessageByGroupId_GroupId : BaseGroupMessageByFilter
{
public string group_id { get; set; }
}

/// <summary>
/// 根据GroupId群发消息筛选
/// </summary>
[Obsolete("请使用BaseGroupMessageDataByFilter")]
public class BaseGroupMessageDataByGroupId : BaseGroupMessageDataByFilter
{

}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_MediaId
{
public string media_id { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_Content
{
public string content { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_WxCard
{
public string card_id { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_VoiceData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_MediaId voice { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_ImageData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_MediaId image { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_TextData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_Content text { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_MpNewsData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_MediaId mpnews { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_MpVideoData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_MediaId mpvideo { get; set; }
}

[Obsolete("请使用GroupMessageByFilter_MediaId")]
public class GroupMessageByGroupId_WxCardData : BaseGroupMessageDataByGroupId
{
public GroupMessageByGroupId_WxCard wxcard { get; set; }
}

#endregion

}

在 GroupMessageApi 中的使用上同样保持了向下兼容，根据 GroupId 和 TagId 群发的接口分别为 SendGroupMessageByGroupId() 以及 SendGroupMessageByTagId()，底层共同调用同一个私有方法 SendGroupMessageByFilter() ：

/// <summary>
/// 根据分组或标签进行群发【订阅号与服务号认证后均可用】
///
/// 请注意：
/// 1、该接口暂时仅提供给已微信认证的服务号
/// 2、虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，请小心测试
/// 3、无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败。
/// 4、群发视频时需要先调用GetVideoMediaIdResult接口获取专用的MediaId然后进行群发
///
/// </summary>
/// <param name="accessTokenOrAppId">AccessToken或AppId（推荐使用AppId，需要先注册）</param>
/// <param name="groupId">群发到的分组的group_id，参见用户管理中用户分组接口，若is_to_all值为true，可不填写group_id；如果groupId和tagId同时填写，优先使用groupId；groupId和tagId最多只能使用一个</param>
/// <param name="tagId">群发到的标签的tag_id，若is_to_all值为true，可不填写tag_id；如果groupId和tagId同时填写，优先使用groupId；groupId和tagId最多只能使用一个</param>
/// <param name="value">群发媒体文件时传入mediaId,群发文本消息时传入content,群发卡券时传入cardId</param>
/// <param name="type"></param>
/// <param name="isToAll">用于设定是否向全部用户发送，值为true或false，选择true该消息群发给所有用户，选择false可根据group_id发送给指定群组的用户</param>
/// <param name="sendIgnoreReprint">待群发的文章被判定为转载时，是否继续群发</param>
/// <param name="timeOut">代理请求超时时间（毫秒）</param>
/// <returns></returns>
private static SendResult SendGroupMessageByFilter(string accessTokenOrAppId, string groupId, string tagId, string value, GroupMessageType type, bool isToAll = false, bool sendIgnoreReprint = false, int timeOut = Config.TIME_OUT)
{
return ApiHandlerWapper.TryCommonApi(accessToken =>
{
string urlFormat = Config.ApiMpHost + "/cgi-bin/message/mass/sendall?access_token={0}";

BaseGroupMessageDataByFilter baseData = null;
BaseGroupMessageByFilter filter = null;
if (groupId.IsNullOrEmpty())
{
filter = new GroupMessageByGroupId()
{
group_id = groupId,
is_to_all = isToAll,
};
}
else
{
filter = new GroupMessageByTagId()
{
tag_id = tagId,
is_to_all = isToAll,
};
}

switch (type)
{
case GroupMessageType.image:
baseData = new GroupMessageByFilter_ImageData()
{
filter = filter,
image = new GroupMessageByGroupId_MediaId()
{
media_id = value
},
msgtype = "image"
};
break;
case GroupMessageType.voice:
baseData = new GroupMessageByFilter_VoiceData()
{
filter = filter,
voice = new GroupMessageByGroupId_MediaId()
{
media_id = value
},
msgtype = "voice"
};
break;
case GroupMessageType.mpnews:
baseData = new GroupMessageByFilter_MpNewsData()
{
filter = filter,
mpnews = new GroupMessageByGroupId_MediaId()
{
media_id = value
},
msgtype = "mpnews"
};
break;
case GroupMessageType.video:
baseData = new GroupMessageByFilter_MpVideoData()
{
filter = filter,
mpvideo = new GroupMessageByGroupId_MediaId()
{
media_id = value
},
msgtype = "mpvideo"
};
break;
case GroupMessageType.wxcard:
baseData = new GroupMessageByFilter_WxCardData()
{
filter = filter,
wxcard = new GroupMessageByGroupId_WxCard()
{
card_id = value
},
msgtype = "wxcard"
};
break;
case GroupMessageType.text:
baseData = new GroupMessageByFilter_TextData()
{
filter = filter,
text = new GroupMessageByGroupId_Content()
{
content = value
},
msgtype = "text"
};
break;
default:
throw new Exception("参数错误。");
//break;
}

baseData.send_ignore_reprint = sendIgnoreReprint ? 0 : 1;//待群发的文章被判定为转载时，是否继续群发

return CommonJsonSend.Send<SendResult>(accessToken, urlFormat, baseData, timeOut: timeOut);

}, accessTokenOrAppId);
}

本次更新同时更新了对应的异步方法。