Skip to main content

OAuth2 for Google APIs

Project description

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 $ cd google-oauth $ python 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.

OAuth2 for service accounts

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 = ''
>>> url = '' \
>>>         '?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.

Project details

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page