[升级说明] 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);
        }

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