微信公眾號，仿照企業(yè)號的思路，增加了標簽管理的功能，對關(guān)注的粉絲可以設(shè)置標簽管理，實現(xiàn)更加方便的分組管理功能。開發(fā)者可以使用用戶標簽管理的相關(guān)接口，實現(xiàn)對公眾號的標簽進行創(chuàng)建、查詢、修改、刪除等操作，也可以對用戶進行打標簽、取消標簽等操作。本篇隨筆主要介紹如何利用C#對公眾號這個較新的特性進行封裝，實現(xiàn)對標簽的管理功能。
1、標簽功能介紹
1）標簽功能替代分組功能，支持多維度定義用戶屬性
運營者可登錄公眾平臺后臺，點擊左側(cè)菜單“用戶管理”后管理已關(guān)注用戶，點擊其中一個用戶右側(cè)的“標簽”小角標可彈出復(fù)選框快速為該用戶添加標簽，且添加標簽復(fù)選框內(nèi)已支持直接新建標簽。
另外，標簽功能接口也已更新，開發(fā)者可調(diào)用接口，實現(xiàn)對標簽和用戶操作。同時，高級群發(fā)接口和個性化菜單接口等已支持根據(jù)標簽實現(xiàn)操作。詳情可查看微信公眾平臺開發(fā)者文檔。
2）優(yōu)化用戶卡片，支持多場景查看用戶頭像大圖與互動數(shù)據(jù)，增強運營者對用戶熟悉度與管理效率
本期新增消息數(shù)、留言數(shù)和贊賞數(shù)等互動數(shù)據(jù)，且顯示用戶關(guān)注時間和支持查看用戶頭像大圖，有利于拉近運營者與用戶的距離。另外， 支持“贊賞功能”和“留言管理”場景直接管理用戶，提升管理效率。
2、標簽的接口封裝
標簽的接口分為兩部分：標簽管理和用戶管理，一個公眾號，最多可以創(chuàng)建100個標簽。標簽功能目前支持公眾號為用戶打上最多三個標簽。
其中標簽管理包括：
1） 創(chuàng)建標簽 2）獲取公眾號已創(chuàng)建的標簽 3）編輯標簽 4）刪除標簽 5）獲取標簽下粉絲列表標簽的用戶管理包括：1）批量為用戶打標簽 2）批量為用戶取消標簽 3）獲取用戶身上的標簽列表
下面分別為幾種接口封裝進行相關(guān)的介紹。
首先按照常規(guī)的方式 ，我們定義好相關(guān)的接口和實現(xiàn)關(guān)系，如下圖所示。
根據(jù)相關(guān)的接口說明，我們可以實現(xiàn)標簽接口的定義，C#代碼如下所示。
/// <summary>
/// 微信標簽管理的API接口
/// 開發(fā)者可以使用用戶標簽管理的相關(guān)接口，實現(xiàn)對公眾號的標簽進行創(chuàng)建、查詢、修改、刪除等操作，也可以對用戶進行打標簽、取消標簽等操作。
/// </summary>
public interface ITagApi
{
/// <summary>
/// 創(chuàng)建標簽
/// 一個公眾號，最多可以創(chuàng)建100個標簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="name">標簽名（30個字符以內(nèi)）</param>
/// <returns></returns>
TagJson CreateTag(string accessToken, string name);
/// <summary>
/// 獲取公眾號已創(chuàng)建的標簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <returns></returns>
List<TagCountJson> GetTagList(string accessToken);
/// <summary>
/// 編輯標簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標簽ID</param>
/// <param name="name">標簽名稱</param>
/// <returns></returns>
CommonResult UpdateTag(string accessToken, int id, string name);
/// <summary>
/// 刪除標簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標簽ID</param>
/// <returns></returns>
CommonResult DeleteTag(string accessToken, int id);
/// <summary>
/// 獲取標簽下粉絲列表
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標簽ID</param>
/// <param name="name">標簽名稱</param>
/// <returns></returns>
GetTagResult GetTag(string accessToken, int id, string next_openid = null);
/// <summary>
/// 批量為用戶打標簽
/// 標簽功能目前支持公眾號為用戶打上最多三個標簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="tagid">標簽ID</param>
/// <param name="openid_list">粉絲列表</param>
/// <returns></returns>
CommonResult BatchTagging(string accessToken, int tagid, List<string> openid_list);
/// <summary>
/// 批量為用戶取消標簽
/// 標簽功能目前支持公眾號為用戶打上最多三個標簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="tagid">標簽ID</param>
/// <param name="openid_list">粉絲列表</param>
/// <returns></returns>
CommonResult BatchUntagging(string accessToken, int tagid, List<string> openid_list);
/// <summary>
/// 獲取用戶身上的標簽列表
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="openid">用戶OpenID</param>
/// <returns></returns>
List<int> GetIdList(string accessToken, string openid);
}
具體我們來看看幾個接口的官方定義數(shù)據(jù)。
1）創(chuàng)建標簽的接口
接口調(diào)用請求說明
http請求方式：POST（請使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON
POST數(shù)據(jù)例子：
{
"tag" : {
"name" : "廣東"http://標簽名
}
}
返回說明（正常時返回的json數(shù)據(jù)包示例）
{
"tag":{
"id":134,//標簽id
"name":"廣東"
}
}
這樣我們就可以定義一個實體類來承載這個返回的數(shù)據(jù)了。
/// <summary>
/// 標簽信息
/// </summary>
public class TagJson
{
/// <summary>
/// 標簽id，由微信分配
/// </summary>
public int id { get; set; }
/// <summary>
/// 標簽名，UTF8編碼
/// </summary>
public string name { get; set; }
}
這樣，創(chuàng)建標簽的完整實現(xiàn)代碼如下所示
/// <summary>
/// 創(chuàng)建標簽
/// 一個公眾號，最多可以創(chuàng)建100個標簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="name">標簽名（30個字符以內(nèi)）</param>
/// <returns></returns>
public TagJson CreateTag(string accessToken, string name)
{
var url = string.Format("https://api.weixin.qq.com/cgi-bin/tags/create?access_token={0}", accessToken);
var data = new
{
tag = new
{
name = name
}
};
var postData = data.ToJson();
var result = JsonHelper<TagCreateResult>.ConvertJson(url, postData);
return result != null ? result.tag : null;
}
2）獲取公眾號已創(chuàng)建的標簽
接口調(diào)用請求說明
http請求方式：GET（請使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN
返回數(shù)據(jù)格式：JSON
返回的數(shù)據(jù)例子：
{
"tags":[{
"id":1,
"name":"黑名單",
"count":0 //此標簽下粉絲數(shù)
},{
"id":2,
"name":"星標組",
"count":0
},{
"id":127,
"name":"廣東",
"count":5
}
]
}
這樣我們就可以定義其返回值為List<TagCountJson>了，其中TagCountJson為對應(yīng)類的屬性即可。
/// <summary>
/// 標簽信息和統(tǒng)計數(shù)量
/// </summary>
public class TagCountJson : TagJson
{
/// <summary>
/// 此標簽下粉絲數(shù)
/// </summary>
public int count { get; set; }
}
這樣我們就可以通過JSON的解析返回對應(yīng)的數(shù)據(jù)了，相關(guān)操作和上面的接口類似，不在贅述。
本篇提供了一個管理標簽的相關(guān)接口思路和相關(guān)實現(xiàn)代碼，希望大家可以有所啟發(fā)和幫助。
如果對這個《C#開發(fā)微信門戶及應(yīng)用》系列感興趣，可以關(guān)注我的其他文章.
