Installation:

1. Install or add django-google-credentials to your Python path.

2. Add google_credentials to your INSTALLED_APPS setting.

3. Add google_credentials URL include to your project’s urls.py file:

   url(r'^google-credentials/', include('google_credentials.urls')),

4. Create your project on the Google API Console, specifying the redirect URL as http://your.domain.com/google-credentials/callback (or however you setup your urls.py as described above).

5. Add the following settings to your project’s settings.py file populated with values as retrieved from Google in the previous step, i.e.:

   GA_CLIENT_ID = '32749234234.apps.googleusercontent.com'
   GA_CLIENT_SECRET = 'DKSFY87sd6fHJGdsf6'
   GA_SCOPE = 'https://www.googleapis.com/auth/analytics.readonly'
   GA_REDIRECT_URI = 'http://your.domain.com/google-credentials/callback'

6. Run syncdb to generate required models.

Usage

Before you can start using a service you have to authorize it with your Google account. To do this open http://your.domain.com/google-credentials/authorize in your browser.

Once authorized you can retrieve a service for further querying like so:

from google_credentials import utils

service = utils.get_service()

To purge previously generated credentials open http://your.domain.com/google-credentials/purge in your browser.