WeChat公式アカウントは、エンタープライズアカウントの考え方に従って、タグ管理の機(jī)能を追加し、フォローしているファンに対してタグ管理を設(shè)定することができ、より便利なグループ管理機(jī)能を?qū)g現(xiàn)します。開発者は、ユーザー タグ管理の関連インターフェイスを使用して、パブリック アカウント タグの作成、クエリ、変更、削除などの操作を行うことができ、ユーザーのタグをタグ付けしたり、タグをキャンセルしたりすることもできます。このエッセイでは主に、C# を使用してパブリック アカウントの新しい機(jī)能をカプセル化し、タグの管理機(jī)能を?qū)g現(xiàn)する方法を紹介します。

1. タグ機(jī)能の紹介

1) タグ機(jī)能はグループ化機(jī)能を置き換え、ユーザー屬性の多次元定義をサポートします

オペレーターはパブリックプラットフォームのバックエンドにログインし、「ユーザー管理」をクリックします。左側(cè)のメニューで、フォローしているユーザーを管理するには、ユーザーの 1 人の右側(cè)にある小さな「ラベル」隅のアイコンをクリックすると、ユーザーにラベルを簡単に追加するためのチェック ボックスが表示されます。ラベルの追加チェック ボックスは、すでに新規(guī)作成をサポートしています。直接ラベルを付けます。

さらに、タグ関數(shù)のインターフェースも更新され、開発者はインターフェースを呼び出してタグとユーザーの操作を?qū)g裝できます。同時(shí)に、高度なグループ メッセージング インターフェイスとパーソナライズされたメニュー インターフェイスは、タグに基づく操作をすでにサポートしています。

2) ユーザーカードを最適化し、ユーザーアバターとインタラクティブデータのマルチシナリオ表示をサポートし、オペレーターのユーザーへの精通性と管理効率を向上させます

この中でのメッセージ、コメント、感謝の數(shù)などの新しいインタラクション課題データやユーザーの注意時(shí)間の表示、ユーザーアバターの大きな畫像表示への対応など、オペレーターとユーザーの距離を縮めることに貢獻(xiàn)します。また、ユーザーを直接管理する「感謝機(jī)能」や「メッセージ管理」シナリオにも対応し、管理効率を向上します。

2. タグインターフェイスのカプセル化

タグインターフェイスは、タグ管理とユーザー管理の 2 つの部分に分かれています。パブリック アカウントは最大 100 個(gè)のタグを作成できます?，F(xiàn)在、ラベル機(jī)能はパブリック アカウントをサポートしており、ユーザーに対して最大 3 つのラベルを付けることができます。

タグ管理には以下が含まれます:

1) タグを作成する 2) 公式アカウントによって作成されたタグを取得する 3) タグを編集する 4) タグを削除する 5) タグの下にあるファンのリストを取得する

ユーザータグの管理には以下が含まれます:

1) バッチでユーザーにタグ付けする 2) バッチでユーザーのタグを解除する 3) ユーザーのタグのリストを取得する

以下は、いくつかのインターフェース パッケージに関連する紹介です。

まず、従來の方法で、以下の図に示すように、関連するインターフェイスと実裝関係を定義します。

関連するインターフェイスの説明に従って、ラベル インターフェイスの定義を?qū)g裝できます。C# コードは次のとおりです。

/// <summary>
/// 微信標(biāo)簽管理的API接口
/// 開發(fā)者可以使用用戶標(biāo)簽管理的相關(guān)接口，實(shí)現(xiàn)對公眾號的標(biāo)簽進(jìn)行創(chuàng)建、查詢、修改、刪除等操作，也可以對用戶進(jìn)行打標(biāo)簽、取消標(biāo)簽等操作。
/// </summary>
public interface ITagApi
{ 
/// <summary>
/// 創(chuàng)建標(biāo)簽
/// 一個(gè)公眾號，最多可以創(chuàng)建100個(gè)標(biāo)簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="name">標(biāo)簽名（30個(gè)字符以內(nèi)）</param>
/// <returns></returns>
TagJson CreateTag(string accessToken, string name);
/// <summary>
/// 獲取公眾號已創(chuàng)建的標(biāo)簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <returns></returns>
List<TagCountJson> GetTagList(string accessToken);
/// <summary>
/// 編輯標(biāo)簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標(biāo)簽ID</param>
/// <param name="name">標(biāo)簽名稱</param>
/// <returns></returns>
CommonResult UpdateTag(string accessToken, int id, string name);
/// <summary>
/// 刪除標(biāo)簽
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標(biāo)簽ID</param>
/// <returns></returns>
CommonResult DeleteTag(string accessToken, int id);
/// <summary>
/// 獲取標(biāo)簽下粉絲列表
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="id">標(biāo)簽ID</param>
/// <param name="name">標(biāo)簽名稱</param>
/// <returns></returns>
GetTagResult GetTag(string accessToken, int id, string next_openid = null);
/// <summary>
/// 批量為用戶打標(biāo)簽
/// 標(biāo)簽功能目前支持公眾號為用戶打上最多三個(gè)標(biāo)簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="tagid">標(biāo)簽ID</param>
/// <param name="openid_list">粉絲列表</param>
/// <returns></returns>
CommonResult BatchTagging(string accessToken, int tagid, List<string> openid_list);
/// <summary>
/// 批量為用戶取消標(biāo)簽
/// 標(biāo)簽功能目前支持公眾號為用戶打上最多三個(gè)標(biāo)簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="tagid">標(biāo)簽ID</param>
/// <param name="openid_list">粉絲列表</param>
/// <returns></returns>
CommonResult BatchUntagging(string accessToken, int tagid, List<string> openid_list);
/// <summary>
/// 獲取用戶身上的標(biāo)簽列表
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="openid">用戶OpenID</param>
/// <returns></returns>
List<int> GetIdList(string accessToken, string openid);
}

いくつかのインターフェースの公式定義データを見てみましょう。

1) タグを作成するためのインターフェース

インターフェース呼び出しリクエストの手順

http リクエストメソッド: POST (https プロトコルを使用してください)

https://api.weixin.qq.com/cgi-bin/tags/ create?access_token=ACCESS_TOKEN

POSTデータ形式：JSON

POSTデータ例：

{
"tag" : {
"name" : "廣東"//標(biāo)簽名
}
}

戻り値の説明（正常時(shí)に返されるJSONデータパケットの例）

{
"tag":{
"id":134,//標(biāo)簽id
"name":"廣東"
}
}

このようにして、運(yùn)ぶエンティティクラスを定義することができますこのデータの返卻。

/// <summary>
/// 標(biāo)簽信息
/// </summary>
public class TagJson
{
/// <summary>
/// 標(biāo)簽id，由微信分配
/// </summary>
public int id { get; set; }
/// <summary>
/// 標(biāo)簽名，UTF8編碼
/// </summary>
public string name { get; set; }
}

このようにして、タグを作成するための完全な実裝コードは次のとおりです

/// <summary>
/// 創(chuàng)建標(biāo)簽
/// 一個(gè)公眾號，最多可以創(chuàng)建100個(gè)標(biāo)簽。
/// </summary>
/// <param name="accessToken">調(diào)用接口憑證</param>
/// <param name="name">標(biāo)簽名（30個(gè)字符以內(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) 公式アカウントによって作成されたタグを取得します

インターフェース呼び出しリクエスト手順

httpリクエストメソッド: GET (https プロトコルを使用してください)

https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN

戻りデータ形式: JSON 戻りデータ例:

{
"tags":[{
"id":1,
"name":"黑名單",
"count":0 //此標(biāo)簽下粉絲數(shù)
},{
"id":2,
"name":"星標(biāo)組",
"count":0
},{
"id":127,
"name":"廣東",
"count":5
}
]
}

このようにして、戻り値を List として定義できます。TagCountJson は、対応するクラスの屬性です。

/// <summary>
/// 標(biāo)簽信息和統(tǒng)計(jì)數(shù)量
/// </summary>
public class TagCountJson : TagJson
{
/// <summary>
/// 此標(biāo)簽下粉絲數(shù)
/// </summary>
public int count { get; set; }
}

このようにして、JSON 解析を通じて対応するデータを返すことができます。関連する操作は上記のインターフェイスと同様であるため、詳細(xì)は説明しません。

C# WeChat 開発の WeChat パブリック アカウント タグ管理機(jī)能に関連するその他の記事については、PHP 中國語 Web サイトに注目してください。