第8行: | 第8行: | ||
params= | params= | ||
{{api_args|list_id|true|int64|需要更新的好友分组ID,建议使用返回值里的idstr,只能更新当前登录用户自己创建的分组。}} | {{api_args|list_id|true|int64|需要更新的好友分组ID,建议使用返回值里的idstr,只能更新当前登录用户自己创建的分组。}} | ||
− | {{api_args|name|false|string| | + | {{api_args|name|false|string|好友分组的名称,不超过10个汉字,20个半角字符。}} |
− | {{api_args|description|false|string| | + | {{api_args|description|false|string|好友分组的描述,不超过70个汉字,140个半角字符。}} |
− | {{api_args|tags|false|string| | + | {{api_args|tags|false|string|好友分组的标签,多个之间用逗号分隔,最多不超过10个,每个不超过7个汉字,14个半角字符。}} |
{{api_args|mode|false|string|好友分组的私有属性,private:私有分组(分组及成员仅自己可见)、public:公开分组(分组所有人可见,成员可见性由参数visible设置),默认为private。}} | {{api_args|mode|false|string|好友分组的私有属性,private:私有分组(分组及成员仅自己可见)、public:公开分组(分组所有人可见,成员可见性由参数visible设置),默认为private。}} | ||
{{api_args|visible|false|int|好友分组成员的可见范围,当且仅当参数mode为public时有效,0:组内成员可见、1:所有人可见,默认为0。}}| | {{api_args|visible|false|int|好友分组成员的可见范围,当且仅当参数mode为public时有效,0:组内成员可见、1:所有人可见,默认为0。}}| |
2012年6月4日 (一) 11:55的版本
friendships/groups/update
更新好友分组
URL
https://api.weibo.com/2/friendships/groups/update.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
list_id | true | int64 | 需要更新的好友分组ID,建议使用返回值里的idstr,只能更新当前登录用户自己创建的分组。 |
name | false | string | 好友分组的名称,不超过10个汉字,20个半角字符。 |
description | false | string | 好友分组的描述,不超过70个汉字,140个半角字符。 |
tags | false | string | 好友分组的标签,多个之间用逗号分隔,最多不超过10个,每个不超过7个汉字,14个半角字符。 |
mode | false | string | 好友分组的私有属性,private:私有分组(分组及成员仅自己可见)、public:公开分组(分组所有人可见,成员可见性由参数visible设置),默认为private。 |
visible | false | int | 好友分组成员的可见范围,当且仅当参数mode为public时有效,0:组内成员可见、1:所有人可见,默认为0。 |
注意事项
- 当前登录用户必须为好友分组的创建者;
- 参数name、description、tags、mode、visible,至少需要传其中一个,否则接口报错;
- 重复的同名分组将给出错误;
- 用户自己创建的分组,相互之间名称不能重复;
- 更新好友分组时,可指定更新为公开分组,分组为所有人可见,其成员是否可见由visible参数指定;
- 参数visible,设置好友分组成员可见性,分为组内成员可见、所有人可见;
调用样例及调试工具
返回结果
JSON示例
{ "id": 3404979794629010, "idstr": "3404979794629010", "name": "同事", "mode": "private", "visible": 0, "like_count": 0, "member_count": 0, "description": "", "tags": [], "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", "user": { "id": 1404376560, "idstr": "1404376560", "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "微博开放平台产品。人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", "profile_url": "zaku", "domain": "zaku", "weihao": "", "gender": "m", "followers_count": 1440, "friends_count": 604, "statuses_count": 3543, "favourites_count": 14, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "geo_enabled": true, "verified": false, "verified_type": -1, "status_id": 3453143964431400, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 286, "lang": "zh-cn" }, "created_at": "Mon Jan 23 12:45:05 +0800 2012" }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问