(“最简单但功能齐全的ChatterAPI类,深受PythonTwitter工具的启发。”,)
chatter的Python项目详细描述
最简单但功能齐全的chatter api类,深受python twitter工具(https://github.com/sixohsix/twitter/)的启发。
安装
简单:
$ easy_install chatter
更好:
$ pip install chatter
Chatter API概述
请参阅本快速入门教程:salesforce的http://www.salesforce.com/us/developer/docs/chatterapi/Content/quickstart.htm。
用法
实例化:
client_id = “YOUR_CHATTER_CLIENT_ID” client_secret = “YOUR_CHATTER_CLIENT_SECRET” auth = chatter.ChatterAuth(client_id, client_secret)
instance_url = “YOUR_USER_INSTANCE_URL” access_token = “YOUR_USER_ACCESS_TOKEN” refresh_token = “YOUR_USER_REFRESH_TOKEN”
- chatter = chatter.Chatter(auth=auth, instance_url=instance_url,
- access_token=access_token, refresh_token=refresh_token)
获取经过身份验证的用户的详细信息:
me = chatter.users.me.get()
注意“get”是隐含的,因此您可以将上面的值减少到:
me = chatter.users.me()
获取其他用户的详细信息
other_user = chatter.users[“005E0000000FpoxIAC”].get()
同样,这可以减少:
other_user = chatter.users[“005E0000000FpoxIAC”]()
另一种方法是,使用“魔法”方法:
other_user = chatter.users._(“005E0000000FpoxIAC”).get()
更新已验证用户的聊天状态:
chatter.feeds.news.me.feed_items.post(text=”Hello world!”)
由于会话过期,有时需要刷新用户的访问令牌底层chattercall类将自动处理此问题,但是您可能希望收到访问令牌更改的通知,以便可以在用户模型中反映这一点。
可以通过access_token_refreshed_回调来执行此操作,传入一个可调用的,然后使用刷新的access token调用回调。
例如
- def my_callback(access_token):
- print “New access_token”, access_token
- chatter = chatter.Chatter(auth=auth, instance_url=instance_url,
- access_token=access_token, refresh_token=refresh_token, access_token_refreshed_callback=my_callback)
其余的希望是不言而喻的!:)
反馈
将反馈/问题等发送到:
- 电子邮箱:steve.winton[at]nixonmcines.co.uk.
- 推特:@stevewinton(http://twitter.com/steveWINton)。