blob: 48ed3a9be0adf0e0e1d92224420d9534f0a11efe [file] [log] [blame]
Joe Gregorioc4fc0952011-11-09 12:21:11 -05001This is python client library for Google's discovery based APIs.
Joe Gregorio48d361f2010-08-18 13:19:21 -04002
Joe Gregorio8097e2a2011-05-17 11:11:34 -04003
Joe Gregorio48d361f2010-08-18 13:19:21 -04004Installation
5============
6
Tom Miller7c95d812010-10-11 11:50:52 -07007To install, simply say
Joe Gregorio48d361f2010-08-18 13:19:21 -04008
Joe Gregorio205a0612011-12-14 11:38:16 -05009 $ easy_install --upgrade google-api-python-client
Tom Miller7c95d812010-10-11 11:50:52 -070010
Tom Miller7c95d812010-10-11 11:50:52 -070011
Joe Gregorio48d361f2010-08-18 13:19:21 -040012Running
13=======
14
Joe Gregorio8097e2a2011-05-17 11:11:34 -040015After following the install directions (using setup.py or setpath.sh) you
Joe Gregorioc4fc0952011-11-09 12:21:11 -050016should be able to cd to samples/plus and run plus.py from there, which will use
17the apiclient library to retrieve a snippet of text from each entry in Google
18Plus. The first time you run it you will be prompted to authorize the
19application to access your plus information.
Joe Gregorio48d361f2010-08-18 13:19:21 -040020
Joe Gregorioc4fc0952011-11-09 12:21:11 -050021 $ python samples/plus/plus.py
Joe Gregorio48d361f2010-08-18 13:19:21 -040022
23
Tom Miller3a49e4c2010-09-28 15:16:25 -070024Third Party Libraries
Joe Gregorioe9e236f2011-03-21 22:23:14 -040025=====================
26
Joe Gregorio20a5aa92011-04-01 17:44:25 -040027These libraries will be installed when you install the client library:
Joe Gregorio48d361f2010-08-18 13:19:21 -040028
29http://code.google.com/p/httplib2
30http://code.google.com/p/uri-templates
Joe Gregorio8097e2a2011-05-17 11:11:34 -040031http://code.google.com/p/python-gflags
Joe Gregorio48d361f2010-08-18 13:19:21 -040032http://github.com/simplegeo/python-oauth2
Joe Gregorio8097e2a2011-05-17 11:11:34 -040033
34Depending on your version of Python, these libraries may also be installed:
35
36http://pypi.python.org/pypi/simplejson/
Joe Gregorio432f17e2011-05-22 23:18:00 -040037
Joe Gregorio7accf7a2011-10-14 12:07:20 -040038For development you will also need:
Joe Gregorio432f17e2011-05-22 23:18:00 -040039
40http://pythonpaste.org/webtest/