用戶標(biāo)簽

獲取所有標(biāo)簽

$officialAccount->userTag->list();

使用示例：

$tags = $officialAccount->userTag->list();

獲取結(jié)果：

{
    "tags": [
        {
            "id": 0,
            "name": "標(biāo)簽1",
            "count": 72596
        },
        {
            "id": 1,
            "name": "標(biāo)簽2",
            "count": 36
        },
        // ...
    ]
}

創(chuàng)建標(biāo)簽

$officialAccount->userTag->create($name);

使用示例：

$officialAccount->userTag->create('測試標(biāo)簽');

修改標(biāo)簽信息

$officialAccount->userTag->update($tagId, $name);

使用示例：

$officialAccount->userTag->update(12, "新的名稱");

刪除標(biāo)簽

$officialAccount->userTag->delete($tagId);

獲取指定 openid 用戶所屬的標(biāo)簽

$userTags = $officialAccount->userTag->userTags($openId);

獲取結(jié)果：

{
    "tagid_list":["標(biāo)簽1","標(biāo)簽2"]
}

獲取標(biāo)簽下用戶列表

<?php

// $nextOpenId：第一個拉取的 OPENID，不填默認(rèn)從頭開始拉取
$officialAccount->userTag->usersOfTag($tagId, $nextOpenId = '');

獲取結(jié)果示例：

{
    "count":2, // 這次獲取的粉絲數(shù)量
    "data":{ // 粉絲列表
         "openid":[
             "ocYxcuAEy30bX0NXmGn4ypqx3tI0",
             "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
         ]
    },
    "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" // 拉取列表最后一個用戶的openid
}

批量為用戶添加標(biāo)簽

<?php

$openIds = [$openId1, $openId2, ...];
$officialAccount->userTag->tagUsers($openIds, $tagId);

批量為用戶移除標(biāo)簽

<?php

$openIds = [$openId1, $openId2, ...];
$officialAccount->userTag->untagUsers($openIds, $tagId);