これまでの記事では、WeChat エンタープライズ アカウントの多くの関連操作を紹介しましたが、エンタープライズ アカウントは公式アカウントと同様にメニューをカスタマイズできるため、API を介してメニューの作成、リストの取得、メニューの削除も行うことができるため、この記事では引き続きメニューについて説明します。エンタープライズアカウントの管理業(yè)務(wù)。

このメニューは、多くの場合、クイック エントリを提供し、OAuth2 検証インターフェイスとカスタマイズされたリダイレクト メニューを通じて、ユーザー情報のメイン エントリを取得するために使用することもでき、対応するユーザー ID を取得できます。さらにユーザーの関連データを取得し、顧客に表示します。

1. メニューの概要

メニューのイベント処理は次のとおりです: クリックとジャンプの 2 つの操作が含まれます。將來的には、エンタープライズ アカウントにいくつかのコード スキャン操作、寫真操作、およびその他の同様の機能が追加される可能性があります。公式アカウントは現(xiàn)在2つだけです。

公式メニュー定義インターフェースには、メニュー作成、リスト取得、メニュー削除の3つの操作が含まれており、公式アカウントの操作とほぼ同様です。

2. メニュー エンティティ クラスの定義とインターフェイス定義の処理

名前、タイプ、キー、URL、それ自體を指すサブメニュー參照などの屬性の定義を含めて、メニューを定義します。メニューは複數(shù)のレベルに周期的に構(gòu)築できますが、厳密に言えば、エンタープライズ アカウントのメニューは公式アカウントのメニューと同じで、第 1 レベルは 3 つ、第 2 レベルは最大 5 つあります。 3番目のレベルのメニュー。

エンティティクラスのUML図を以下に示します。

メニュー管理の作成操作、正式な定義は以下の通りです。

リクエスト手順
HTTPSリクエストメソッド: POST

https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=1

リクエストパッケージは次のとおりです:

{
???"button":[
???????{	
???????????"type":"click",
???????????"name":"今日歌曲",
???????????"key":"V1001_TODAY_MUSIC"
???????},
???????{
???????????"name":"菜單",
???????????"sub_button":[
???????????????{
???????????????????"type":"view",
???????????????????"name":"搜索",
???????????????????"url":"http://www.soso.com/"
???????????????},
???????????????{
???????????????????"type":"click",
???????????????????"name":"贊一下我們",
???????????????????"key":"V1001_GOOD"
???????????????}
???????????]
??????}
???]
}

パラメータの説明

パラメータaccess_tokenagentid ボタンサブボタンtypenameキーurl

must	の説明
は	呼び出し側(cè)インターフェースの認(rèn)証情報です
は	の ID ですエンタープライズ アプリケーション、整數(shù)型。アプリケーションの設(shè)定ページで確認(rèn)できます
はい	第一レベルのメニュー配列、番號は1~3である必要があります
いいえ	第二レベルのメニュー配列、數(shù)字は 1 ~ 5 です。
は	メニューの応答アクションのタイプです?，F(xiàn)在、クリックとビューの 2 つのタイプがあります。
は	メニューのタイトルです。 16 バイト以上、サブメニューは不可 40 バイト以下
クリックタイプ必須	メニュー KEY 値、メッセージインターフェイスプッシュに使用、128 バイト以下
ビュータイプ必須	webリンク、従業(yè)員がメニューをクリック リンクは 256 バイト以內(nèi)で開くことができます

権限の説明
管理者はアプリケーションの管理権限を持っている必要があり、アプリケーションはコールバック モードに設(shè)定されている必要があります。

Return result

{
???"errcode":0,
???"errmsg":"ok"
}

上記の公式定義セマンティクスによると、メニュー管理の C# 管理インターフェイス定義は次のとおりです。

????///?<summary>
????///?企業(yè)號菜單管理接口定義????///?</summary>
????public?interface?ICorpMenuApi
????{????????///?<summary>
????????///?獲取菜單數(shù)據(jù)????????///?</summary>
????????///?<param name="accessToken">調(diào)用接口憑證</param>
????????///?<returns></returns>
????????MenuListJson?GetMenu(string?accessToken,?string?agentid);????????///?<summary>
????????///?創(chuàng)建菜單????????///?</summary>
????????///?<param name="accessToken">調(diào)用接口憑證</param>
????????///?<param name="menuJson">菜單對象</param>
????????///?<returns></returns>
????????CommonResult?CreateMenu(string?accessToken,?MenuListJson?menuJson,?string?agentid);????????///?<summary>
????????///?刪除菜單????????///?</summary>
????????///?<param name="accessToken">調(diào)用接口憑證</param>
????????///?<returns></returns>
????????CommonResult?DeleteMenu(string?accessToken,?string?agentid);
????}

WeChat エンタープライズ アカウント メニューの操作を紹介するために、メニューの作成の実裝を例に挙げます。他の操作も同様で、簡単に処理および読み取りできるようにパブリック メッセージ クラスを返します。以下に続きます。

????????///?<summary>
????????///?創(chuàng)建菜單????????///?</summary>
????????///?<param name="accessToken">調(diào)用接口憑證</param>
????????///?<param name="menuJson">菜單對象</param>
????????///?<returns></returns>
????????public?CommonResult?CreateMenu(string?accessToken,?MenuListJson?menuJson,?string?agentid)
????????{????????????var?url?=?string.Format("http://www.miracleart.cn/{0}&agentid={1}",?accessToken,?agentid);????????????string?postData?=?menuJson.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}

3. Enterprise Account メニュー管理インターフェイスの呼び出しと処理の効果

呼び出しコードとレンダリングは次のとおりです。

????????private?void?btnMenuCreate_Click(object?sender,?EventArgs?e)
????????{
????????????MenuJson?productInfo?=?new?MenuJson("產(chǎn)品介紹",?new?MenuJson[]?{?
????????????????new?MenuJson("軟件產(chǎn)品介紹",?ButtonType.click,?"event-software")
????????????????,?new?MenuJson("框架源碼產(chǎn)品",?ButtonType.click,?"event-source")
????????????????,?new?MenuJson("軟件定制開發(fā)",?ButtonType.click,?"event-develop")
????????????});

????????????MenuJson?frameworkInfo?=?new?MenuJson("框架產(chǎn)品",?new?MenuJson[]?{?
????????????????new?MenuJson("Win開發(fā)框架",?ButtonType.click,?"win"),????????????????new?MenuJson("WCF開發(fā)框架",?ButtonType.click,?"wcf"),????????????????new?MenuJson("混合式框架",?ButtonType.click,?"mix"),?
????????????????new?MenuJson("Web開發(fā)框架",?ButtonType.click,?"web")
????????????????,new?MenuJson("代碼生成工具",?ButtonType.click,?"database2sharp")
????????????});

????????????MenuJson?relatedInfo?=?new?MenuJson("相關(guān)鏈接",?new?MenuJson[]?{?
????????????????new?MenuJson("公司介紹",?ButtonType.click,?"event_company"),????????????????new?MenuJson("官方網(wǎng)站",?ButtonType.view,?"http://www.miracleart.cn/"),????????????????new?MenuJson("聯(lián)系我們",?ButtonType.click,?"event_contact"),????????????????new?MenuJson("應(yīng)答系統(tǒng)",?ButtonType.click,?"set-1"),????
????????????????new?MenuJson("發(fā)郵件",?ButtonType.view,?"http://www.miracleart.cn/")
????????????});

????????????MenuListJson?menuJson?=?new?MenuListJson();
????????????menuJson.button.AddRange(new?MenuJson[]?{?productInfo,?frameworkInfo,?relatedInfo?});????????????//Console.WriteLine(menuJson.ToJson());

????????????if?(MessageUtil.ShowYesNoAndWarning("您確認(rèn)要創(chuàng)建菜單嗎")?==?System.Windows.Forms.DialogResult.Yes)
????????????{
????????????????ICorpMenuApi?bll?=?new?CorpMenuApi();?
????????????????CommonResult?result?=?bll.CreateMenu(token,?menuJson,?agentid);
????????????????Console.WriteLine("創(chuàng)建菜單："?+?(result.Success???"成功"?:?"失敗:"?+?result.ErrorMessage));
????????????}
????????}????????private?void?btnMenuGet_Click(object?sender,?EventArgs?e)
????????{
????????????ICorpMenuApi?bll?=?new?CorpMenuApi();
????????????MenuListJson?menu?=?bll.GetMenu(token,?agentid);????????????if?(menu?!=?null)
????????????{
????????????????Console.WriteLine(menu.ToJson());
????????????}
????????}

呼び出しコードのテスト出力を以下に示します。

WeChat ポータルの C# 開発と WeChat エンタープライズ アカウントのメニュー管理のアプリケーションについては、PHP 中國語 Web サイトの関連記事に注目してください。