微信公衆平臺開發文檔 用戶分組管理

開發者能夠使用接口，對公衆平臺的分組進行查詢、建立、修改操做，也能夠使用接口在須要時移動用戶到某個分組。

目錄 [隱藏] 1 建立分組 2 查詢全部分組 3 查詢用戶所在分組 4 修改分組名 5 移動用戶分組

建立分組

一個公衆帳號，最多支持建立500個分組。 接口調用請求說明

http請求方式: POST（請使用https協議）
https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
POST數據格式：json
POST數據例子：{"group":{"name":"test"}}

參數說明

參數	說明
access_token	調用接口憑證
name	分組名字（30個字符之內）

返回說明 正常時的返回JSON數據包示例：

{
    "group": {
        "id": 107, 
        "name": "test"
    }
}

參數說明

參數	說明
id	分組id，由微信分配
name	分組名字，UTF8編碼

錯誤時的JSON數據包示例（該示例爲AppID無效錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

全局返回碼說明

使用網頁調試工具調試該接口

 

查詢全部分組

接口調用請求說明

http請求方式: GET（請使用https協議）
https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN

參數說明

參數	說明
access_token	調用接口憑證

返回說明 正常時的返回JSON數據包示例：

{
    "groups": [
        {
            "id": 0, 
            "name": "未分組", 
            "count": 72596
        }, 
        {
            "id": 1, 
            "name": "黑名單", 
            "count": 36
        }, 
        {
            "id": 2, 
            "name": "星標組", 
            "count": 8
        }, 
        {
            "id": 104, 
            "name": "華東媒", 
            "count": 4
        }, 
        {
            "id": 106, 
            "name": "★不測試組★", 
            "count": 1
        }
    ]
}

參數說明

參數	說明
groups	公衆平臺分組信息列表
id	分組id，由微信分配
name	分組名字，UTF8編碼
count	分組內用戶數量

錯誤時的JSON數據包示例（該示例爲AppID無效錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

全局返回碼說明

使用網頁調試工具調試該接口

查詢用戶所在分組

經過用戶的OpenID查詢其所在的GroupID。 接口調用請求說明

http請求方式: POST（請使用https協議）
https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN
POST數據格式：json
POST數據例子：{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}

參數說明

參數	說明
access_token	調用接口憑證
openid	用戶的OpenID

返回說明 正常時的返回JSON數據包示例：

{
    "groupid": 102
}

參數說明

參數	說明
groupid	用戶所屬的groupid

錯誤時的JSON數據包示例（該示例爲OpenID無效錯誤）：

{"errcode":40003,"errmsg":"invalid openid"}

全局返回碼說明

使用網頁調試工具調試該接口

修改分組名

接口調用請求說明

http請求方式: POST（請使用https協議）
https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN
POST數據格式：json
POST數據例子：{"group":{"id":108,"name":"test2_modify2"}}

參數說明

參數	說明
access_token	調用接口憑證
id	分組id，由微信分配
name	分組名字（30個字符之內）

返回說明 正常時的返回JSON數據包示例：

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

錯誤時的JSON數據包示例（該示例爲AppID無效錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

全局返回碼說明

使用網頁調試工具調試該接口

移動用戶分組

接口調用請求說明

http請求方式: POST（請使用https協議）
https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN
POST數據格式：json
POST數據例子：{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}

參數說明

參數	說明
access_token	調用接口憑證
openid	用戶惟一標識符
to_groupid	分組id

返回說明 正常時的返回JSON數據包示例：

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

錯誤時的JSON數據包示例（該示例爲AppID無效錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

全局返回碼說明

使用網頁調試工具調試該接口