google-oauth
aims to implement Google OAuth2.
Requires Python 2.7 or 3.3+.
Use pip
:
$ pip install google-oauth
Or download code rom GitHub and install it manually with setuptools
:
$ git clone https://github.com/miedzinski/google-oauth2-service.git $ cd google-oauth $ python setup.py install
In case of pyOpenSSL
build failing, install openssl headers. On Debian based distributions:
$ apt-get install libssl-dev
At this moment, there is only Server to Server flow implemented.
First, create ServiceAccount
object. The best way to achieve this is using one of two classmethods:
- ServiceAccount.from_json
- ServiceAccount.from_pkcs12
Google recommends JSON key format, so we will use it. Both methods are documented in source code.
>>> key = json.load(open('/path/to/credentials.json')) >>> auth = ServiceAccount.from_json(key=key, scopes=scope) >>> auth.access_token
And that's it - OAuth2 access token is available as access_token
property. If you think token's lifetime will be longer than object's, you can cache it in file or database of your choice. Otherwise, you can use a GoogleService.authorized_request
, which is a handy shortcut to requests.request
with proper Authorization
header. Subsequent calls to this method won't request new access tokens unless previous one expired.
Let's search for Guuido van Rossum on Google+
>>> scope = 'https://www.googleapis.com/auth/plus.login' >>> url = 'https://www.googleapis.com/plus/v1/people' >>> '?query=Guuido+van+Rossum' >>> resp = auth.authorized_request(method='get', url=url)
resp
is now an instance of requests.Response
, from which we can extract all the data we need.
Source code is fully documented with docstrings.
- Implement three-legged OAuth2 (for web server applications).
All contributors are welcome! Make sure the tests pass and don't forget to write your own tests if you code new stuff. If you want to submit a patch, use GitHub pull requests.