Skip to main content
Help us improve Python packaging – donate today!

This package contains useful tools for talking with Google Analytics

Project Description

This package contains useful tools for talking with Google Analytics.

Main features

  1. A low level API to access Google API;
  2. A CMF portal tool to store Google connections;
  3. Logic to authenticate with Google Analytics without touching Google credentials using AuthSub tokens
  4. Logic to create custom Google Analytics reports using Google Analytics Data Export API.

Google Analytics reports created this way can be made available via portlets. Right now there is an example under skins folder.

Google API (

A python package that provides a low level Google Connection and a generic connection error GoogleClientError. To use this connection you’ll need an AuthBase authentication token. You can get one by calling Google like:

After you login into your Google Analytics account, you’ll be asked to grant access to to access Analytics statistics. If you do so, Google will redirect your browser to the next link provided, adding a request parameter token=<one-session-authsub-token>, in our case

As this token was provided in clear to you, it can be used only once to query Google API, that’s why you’ll need to exchange it for a multi-session one. But this time you can not do it from browser. So here comes in.

>>> from import Connection
>>> google = Connection(token='ADFAFDDKLJH14234__ASDD')
>>> new_token = google.token2session()

If you provided an invalid token it will quietly fail and return you a None object, else it will return you a multi-session token. Now you are connected with Google, forever :).

With this connection you can check it’s status:

>>> google.status
(200, 'OK')

Or make a call:

>>> response = google(scope, data, method='GET')
  • scope - the Google service you want to access;
  • data - query parameters
  • method - request method: GET or POST

If something doesn’t work well this will raise a GoogleClientError, else it will return a Google Data Feed Response

<?xml ...

You can also make a safe request by calling .request method. This will return a None object if something works wrong.

>>> google.request(scope, data, method='GET')

Google Tool (

A CMF portal tool that can be retrieved using CMF method getToolByName: This a simple container for Google connections. It provides a basic browser interface to add and remove connections.

>>> from Products.CMFCore.utils import getToolByName
>>> tool = getToolByName(portal, 'portal_google')

Google Analytics (

This package provides the browser interface to register with Google Analytics and defines two storage models: Analytics and AnalyticsReport. Also it provides a utility to easily access low level api.Connection and another one to parse Google response XML.


This will store AuthSub token and it’s also a container for Analytics Reports. It provides a basic browser interface to get token from Google and to manage reports.

Analytics Report

A Google Analytics custom report by dimensions, metrics, start-date, end-date, filters and sort order. It is actually a query object for Google Analytics API.

>>> from zope.component import getMultiAdapter
>>> report =
>>> xml = getMultiAdapter((report, request), 'index.xml')

Now you have a custom XML report based on defined filters.

Connection Utility

Easily access low level using zope components

>>> from zope.component import getUtility
>>> from import IGoogleAnalyticsConnection
>>> utility = getUtility(IGoogleAnalyticsConnection)
>>> conn = utility(token='ABCDEFGH__FAH')

XML Parser utility

Parse Google reponse XML

>>> from zope.component import getUtility
>>> from import IXMLParser
>>> parse = getUtility(IXMLParser)
>>> table = parse(xml)

Here table is a (dimensions, metrics) python generator

>>> dimensions, metrics =
>>> dimensions
{'ga:pagePath': '/some/doc/path', 'ga:browser': 'Firefox'}
>>> metrics
{'ga:pageviews': u'34235', 'ga:timeOnPage': '2433.0'}


  1. python2.4+
  2. Plone 2.5.x or Plone 3.x. (optional if you’re using only package).


EEA - European Enviroment Agency (EU)


4.8 - (2014-01-22)

  • Feature: adding Sphinx-generated documentation in Page Template format [batradav refs #9502]
  • Bug fix: removed wrongly added blockquotes within README.rst [ichim-david refs #18064]

4.7 - (2013-10-04)

  • Change: updated zope imports with the versions that require minimum Plone 4.1 for [ichimdav refs #15651]

4.6 - (2013-06-17)

  • Change: updated link to site setup [ghicale]

4.5 - (2013-02-04)

  • Bug Fix: Fixed to work with the 2.4 API [batradav refs #9551]

4.4 - (2012-07-13)

  • Bug Fix: Fixed i18n missing tags in .pt files [prospchr refs #5160]

4.3 - (2012-06-12)

  • Bug fix: fixed markup of HISTORY.txt file [ciobabog refs #5231]

4.2 - (2012-02-06)

  • No changes

4.0 - (2011-11-07)

  • Cleanup: of pylint, pyflakes warnings [ichimdav #4140, #4141]
  • Feature: added upgrade steps [voineali #4392]
  • Feature: Plone 4.x compatible release [ghicaale #4212]

1.2 (2010-02-24)

  • Bug fix: fixed stinky egg [ghicale]

1.1 (2010-02-24)

  • Bug fix: fixed layout in edit mode [voineali #2685]

1.0 (2009-11-09)

  • Initial release [voineali]

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (135.0 kB) Copy SHA256 hash SHA256 Source None Jan 23, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page