新浪微博Python SDK笔记——获取粉丝列表或关注列表

上一节中创建了一个initclient包，封装了授权的过程，通过获取的myAPIClient对象可以直接调用API接口进行微博操作，上一节中就调用了发微博的接口发了一条新微博。这一节还是直接使用initclient包，调用获取关注好友或粉丝的API来获取好友数据，并将实现的获取好友信息的功能封装在getfriends.py中，然后实现了main.py调用了其中的接口，获取了好友信息并打印出来，运行的结果如图1所示。

 


图1
【说明】：

（1）可以看出，授权过程跟上一节完全一样，是从文件中读取的上一次成功授权的access_token，没有重新进行授权；

（2）以列表的形式输出了好友的几项主要信息：uid，性别，屏幕名称和个人描述。

下面看一下getfriends.py的源码：

#! /usr/bin/python
import time
PAGE_SIZE = 200

def print_users_list(ul):
"""
打印用户列表的详细信息
"""
index = 0
for user in ul:
uid = user["id"]
ugen = user["gender"]
uname = user["screen_name"]
#		uloc = user["location"]
udesc = user["description"]
print "%-6d%-12d%-3s%s%s" % (index, uid, ugen, uname.ljust(20), udesc.ljust(40))
index += 1

def get_friends(client, uid=None, maxlen=0):
"""
读取uid用户的关注用户列表，默认uid=None，此时uid赋值为client.uid，而client.uid表示的是当前授权用户的uid.
"""
if not uid:
uid = client.uid
return get_users(client, False, uid, maxlen)

def get_followers(client, uid=None, maxlen=0):
"""
读取uid用户的粉丝列表，默认uid=None，此时uid赋值为client.uid，而client.uid表示的是当前授权用户的uid.
"""
if not uid:
uid = client.uid
return get_users(client, True, uid, maxlen)

def get_users(client, followersorfriends, uid, maxlen):
"""
调用API读取uid用户的关注用户列表或者粉丝列表，followersorfriends为True读取粉丝列表，为False读取关注好友列表，
参数maxlen设置要获取的好友列表的最大长度，为0表示没有设置最大长度，此时会尝试读取整个好友列表，但是API对于读取的
好友列表的长度会有限制，测试等级最大只能获取一个用户的5000条好友信息。
"""
fl = []
next_cursor = 0
while True:
if followersorfriends:
raw_fl = client.friendships.followers.get(uid=uid, cursor=next_cursor, count=PAGE_SIZE)
else:
raw_fl = client.friendships.friends.get(uid=uid, cursor=next_cursor, count=PAGE_SIZE)
fl.extend(raw_fl["users"])
next_cursor = raw_fl["next_cursor"]
if not next_cursor:
break
if maxlen and len(fl) >= maxlen:
break
time.sleep(1)
return fl

【说明】：

（1）该模块中一共4个函数，get_friends和get_followers分别为获取关注好友和粉丝的接口，print_users_list为打印好友详细信息的接口。get_users为调用API的实现函数；

（2）获取关注好友和获取粉丝的API非常相似，前者是client.friendships.friends.get，后者是client.friendships.followers.get，所以我二者封装在get_users函数中，通过参数followersorfriends表示要获取的类型，接口get_followers和get_friends调用该函数，分别传入True和False；

（3）get_users函数的最后一个参数maxlen设置要获取的好友列表的最大长度，因为用户的好友列表有可能非常长，不需要全部获取时就可以设置maxlen。如果maxlen为0表示没有设置最大长度，此时会尝试读取整个好友列表，为什么说是“尝试”呢？因为API对于好友列表的获取时有限制的，测试等级最大只能获取一个用户的5000条好友信息（这个在官方文档中有说明）；

（4）调用API时有一个参数count=PAGE_SIZE，因为该API读取好友列表时是按页读取的，该参数表示页的大小（即好友信息条数），默认为50，最大为200，这里设置为200，这些官方文档中都有详细说明；

（5）调用API时有一个参数cursor，表示要读取下一页的首条记录序号，每成功读取一页数据，数据中都包含了next_cursor属性，下次继续读取时从next_cursor开始读，关于cursor的详细情况可以阅读官方的API手册；

（6）print_users_list打印好友详细信息，其实详细信息项目非常的多，这里只是打印了其中的几项，可以根据自己的需要修改。

 

下面看一下main.py的源代码：

#! /usr/bin/python

from initclient import initclient
import getfriends

APP_KEY = '2024******'
APP_SECRET = '91a57*************************'
CALLBACK = 'http://bingbingrobot.sinaapp.com/'

def main():
client = initclient.get_client(APP_KEY, APP_SECRET, CALLBACK)
print "===> creat client successfully, authorised uid is : ", client.uid
print "============================== users ==========================="
#读取当前授权用户的粉丝列表
fl = getfriends.get_followers(client)

#读取当前授权用户的关注好友列表
#	fl = getfriends.get_friends(client)

#读取uid为‘1497035431’的用户的粉丝列表
#uid = '1497035431'	#梁斌penny
#	fl = getfriends.get_followers(client, uid=uid)

getfriends.print_users_list(fl)

if __name__ == '__main__':
main()

【说明】：

有了授权模块initclient和获取好友模块getfriends.py，main.py的内容就非常简单了。创建myAPIClient对象，调用getfriends模块的get_friends或get_followers接口获取好友数据，然后调用print_users_lis接口打印。非常简单，不在啰嗦了！

 

【总结】：

这两节中创建的initclient模块和getfriends模块都可以复用，开发其他功能时都可以直接使用，例如要对好友信息进行统计（如统计男女比例、兴趣分布、地区分布等）时，先用getfriends模块获取好友列表。

 

By: