取得公众号的用户组

取得公众号的用户组

功能说明

使用 Senparc SDK 可以快速获取微信公众平台中配置的用户分组信息。用户分组可在微信公众平台后台手动创建和管理，也可通过 API 进行增删改查。

实现代码

/// <summary>
/// 取得用户组
/// </summary>
/// <returns></returns>
public JsonResult GetGroupList()
{
    var accessToken = AccessTokenContainer.TryGetAccessToken(appId, appSecret);
    GroupsJson groupJson = GroupsApi.Get(accessToken);
    return Json(groupJson.groups, JsonRequestBehavior.AllowGet);
}Code language: PHP (php)

关键点说明

• GroupsApi.Get(accessToken)：调用微信”获取用户分组”接口，返回 GroupsJson 对象。
• groupJson.groups：为一个分组列表，每个分组包含以下主要属性：
  • id：分组 ID
  • name：分组名称
  • count：分组内用户数量
• AccessTokenContainer.TryGetAccessToken()：SDK 封装的 AccessToken 获取方法，内部自动处理缓存和过期刷新，无需手动管理。
• 返回 JsonResult 并设置 JsonRequestBehavior.AllowGet，允许 GET 请求直接访问，方便在浏览器或前端调试。

返回数据示例

[
  {"id": 0, "name": "未分组", "count": 125},
  {"id": 1, "name": "黑名单", "count": 3},
  {"id": 100, "name": "VIP用户", "count": 42}
]Code language: JSON / JSON with Comments (json)

注意：微信公众平台默认包含”未分组”（id=0）和”黑名单”（id=1）两个分组，其余为自定义分组。分组 ID 为整型，不可重复。