用于使用vimeo api的python模块。
vimeo的Python项目详细描述
用于使用Vimeo API的python包装器。
安装
要安装python vimeo,只需:
pip install vimeo
或
easy_install vimeo
基本用途
要使用python vimeo,必须首先创建一个客户机实例, 至少传递您在registered your app:
import vimeo client = vimeo.Client(key=YOUR_CONSUMER_KEY, secret=YOUR_CONSUMER_SECRET, callback=YOUR_CALLBACK_URL)
然后可以使用客户端实例来获取或修改资源:
videos = client.get('vimeo.videos.getAll', user_id=11867661, page=1)
身份验证
vimeo api支持的所有OAuth authorization flows都是 在python vimeo中提供。如果您只需要只读访问 公共资源,按照上面所示的基本使用方法。但是, 您需要访问私有资源或修改资源, 您需要具有对应用程序的用户委派访问权限。待办事项 这样,您就可以使用下面的oauth2授权流。
授权代码流
授权代码流包括将用户重定向到vimeo.com 他们将在何处登录并授予对您的应用程序的访问权限:
import vimeo client = vimeo.Client( key='YOUR_CONSUMER_KEY', secret='YOUR_CONSUMER_SECRET', callback='YOUR_CALLBACK_URL', username='USERNAME_FROM_YOU_APP' ) redirect(client.authorize_url())
请注意,用户名应该是应用程序中唯一的登录用户名。 身份验证信息将存储在指定用户名的单独缓存中。 并且回调必须与您提供的值相匹配 注册了你的申请。授予访问权限后,用户将 重定向到此URL,此时应用程序可以交换 返回的访问令牌的令牌信息。在得到信息后 通过令牌验证程序:
token = client.exchange_token('TOKEN_VERIFIER') access_token = token.key access_token_secret = token.secret
示例
获取用户授权:
import vimeo client = vimeo.Client(key=YOUR_CONSUMER_KEY, secret=YOUR_CONSUMER_SECRET, callback=YOUR_CALLBACK_URL, username='LOGGED IN USERNAME') redirect(client.authorize_url())
获取经过身份验证的用户上传的视频:
import vimeo client = vimeo.Client(key=YOUR_CONSUMER_KEY, secret=YOUR_CONSUMER_SECRET, callback=YOUR_CALLBACK_URL, username='LOGGED_IN_USERNAME', token=False) token = client.exchange_token('TOKEN_VERIFIER_FROM_THE_REDIRECTED_URL') client = vimeo.Client(key=YOUR_CONSUMER_KEY, secret=YOUR_CONSUMER_SECRET, callback=YOUR_CALLBACK_URL, username='LOGGED_IN_USERNAME', token=True) videos = client.get('vimeo.videos.getUploaded', page=1)