[TOC] ####接口權限  訂閱號， 認證訂閱號， 服務號， 認證服務號 #### 標簽管理 開發者可以使用用戶標簽管理的相關接口，實現對公眾號的標簽進行創建、查詢、修改、刪除等操作，也可以對用戶進行打標簽、取消標簽等操作。 #####獲取所有標簽 >[info] fansTagFetchAll() ``` $account_api = WeAccount::create(); $result = $account_api->fansTagFetchAll(); if (is_error($result)) { message('獲取標簽失敗'); } /**結果如下 array( 'tags' => array( 0 => array('id' => 1, 'name' => '微擎1', 'count' => '標簽下的粉絲數'), 1 => array('id' => 2, 'name' => '微擎2', 'count' => '標簽下的粉絲數'), ), ); **/ //入庫或是其它代碼 ``` #####新建粉絲標簽 >[info] fansTagAdd($tagname) * $tagname 標簽名稱 ``` $account_api = WeAccount::create(); $result = $account_api->fansTagAdd('測試標簽'); if (is_error($result)) { message('添加標簽失敗'); } $tagid = $result['tag']['id']; //標簽ID //入庫或是其它代碼 ``` #####編輯標簽 >[info] fansTagEdit($tagid, $tagname) * $tagid 標簽id，添加成功后返回的id * $tagname 標簽名稱 ``` $account_api = WeAccount::create(); $result = $account_api->fansTagEdit('1', '測試標簽1'); if (is_error($result)) { message('修改標簽失敗'); } //入庫或是其它代碼 ``` ##### 刪除標簽 >[info] fansTagDelete($tagid) * $tagid 標簽id，添加成功后返回的id ``` $account_api = WeAccount::create(); $result = $account_api->fansTagDelete('1'); if (is_error($result)) { message('刪除標簽失敗'); } //入庫或是其它代碼 ``` #### 粉絲標簽管理 ##### 獲取粉絲擁有的標簽 >[info] fansTagFetchOwnTags($openid) * $openid 粉絲opendid ``` $account_api = WeAccount::create(); $fanstag = $account_api->fansTagFetchOwnTags('fromuser'); if (is_error($fanstag)) { message('獲取粉絲標簽失敗'); } /** $fanstag 結構如下： array( 'tagid_list' = array('1', '2', '標簽ID3', '標簽ID4') ) **/ //入庫或是其它代碼 ``` ##### 設置粉絲標簽 >[info] fansTagTagging($openid, $tagids) 此函數會直接覆蓋粉絲當前擁有的標簽。 * $openid 粉絲opendid * $tagids 標簽id，最多為三個，結構為array(1, 2, 3) ``` $account_api = WeAccount::create(); $result = $account_api->fansTagTagging('fromuser', array(1, 2)); if (is_error($result)) { message('設置粉絲標簽失敗'); } //入庫或是其它代碼 ``` >[warning] 這里需要特別注意的是，批量設置粉絲標簽時，每個粉絲最多只能擁有三個標簽，如果粉絲擁有一個標簽時，要為其設置三個標簽，需要先把其擁有的標簽先刪除掉。 ##### 批量設置標簽 >[info] fansTagBatchTagging($openid_list, $tagid) * $openid_list 粉絲opendid列表，結構為array('openid1', 'openid2') * $tagid 標簽id ``` $account_api = WeAccount::create(); $result = $account_api->fansTagBatchTagging(array('fromuser', 'fromuser1'), 1); if (is_error($result)) { message('設置粉絲標簽失敗'); } //入庫或是其它代碼 ``` ##### 批量取消標簽 >[info] fansTagBatchUntagging($openid_list, $tagid) * $openid_list 粉絲opendid列表，結構為array('openid1', 'openid2') * $tagid 標簽id ``` $account_api = WeAccount::create(); $result = $account_api->fansTagBatchUntagging(array('fromuser', 'fromuser1'), 1); if (is_error($result)) { message('取消粉絲標簽失敗'); } //入庫或是其它代碼 ``` #### 標簽與分組的對應關系 由于微信最開始是設置粉絲分組（只支持一個分組），后來改為粉絲標簽。標簽的數據是兼容分組數據的，大家可以理解為之前的分組是粉絲的一個標簽。 微擎也根據相應的變化做了相關函數的調整，具體對應的差別如下： |舊函數名|新函數名|說明| | -- | -- | -- | |addFansGroup|fansTagAdd|新增一個粉比例標簽| |editFansGroupname|fansTagEdit($tagid, $tagname)|編輯標簽名稱| |delFansGroup|fansTagDelete($tagid)|刪除一個標簽| |fetchFansGroups|fansTagFetchAll|獲取全部粉絲標簽| |fetchFansGroupid|fansTagFetchOwnTags($openid)|獲取某個粉絲的全部標簽| |updateFansGroupid|fansTagTagging($openid, $tags)|給單個粉絲打標簽，$tags參數結構為 array('tag1', 'tag2', 'tag3')| | |fansTagBatchTagging($openid_list, $tagid)|批量為粉絲打標簽| | |fansTagBatchUntagging($openid_list, $tagid)|批量取消粉絲標簽|