前面幾篇陸續(xù)介紹了許多微信企業(yè)號的相關(guān)操作，企業(yè)號和公眾號一樣都可以自訂選單，因此他們也可以透過API進行選單的建立、取得清單、刪除的操作，因此本篇繼續(xù)探討這個主體，介紹企業(yè)號的選單管理操作。

菜單在很多情況下，能夠給我們提供一個快速入口，也可以用來獲取用戶信息的主要入口，通過OAuth2驗證接口，以及自定義的重定向菜單，我們就可以獲得對應(yīng)的用戶ID，然後進一步取得到用戶的相關(guān)數(shù)據(jù)，可以顯示給客戶。

1、選單的整體介紹

選單的事件處理如下所示，包括了點擊和跳轉(zhuǎn)兩個操作，未來企業(yè)號可能會增加一些和公眾號一樣的掃碼操作，拍照操作等功能的，目前只有兩個。

官方的選單定義介麵包含了以下三種操作，選單建立、清單取得和選單刪除，這一點和公眾號操作幾乎一樣了。

?

2、選單的實體類別定義和介面定義處理

我們定義選單，包括定義它的一些屬性，包含有name, type, key,url,以及一個指向自身引用的子選單引用，因此菜單可以循環(huán)構(gòu)造多個層次，雖然嚴(yán)格意義上來講，企業(yè)號的菜單和公眾號菜單一樣，一級三個，二級最多五個，而且沒有三級菜單了。

實體類別的UML圖示如下所示。

選單管理的建立操作，官方定義如下所示。

• 請求說明

Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token.weixin.qq.com/cgi-bin/menu/create?access_token=ACCken_token;

{
???"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"
???????????????}
???????????]
??????}
???]
}

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

我們以創(chuàng)建菜單的實現(xiàn)為例來介紹微信企業(yè)號菜單的操作，其他的操作類似處理，都是返回一個公共的消息類，方便處理和讀取，代碼如下所示。

????///?<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);
????}

?

3、企業(yè)號選單管理介面的呼叫與處理效果

????????///?<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://m.miracleart.cn/{0}&agentid={1}",?accessToken,?agentid);????????????string?postData?=?menuJson.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}