blob: f54a3cb4d9cba94a39f585ee6e996d2f4e918c25 [file] [log] [blame] [view]
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
Craig Citro3f8dc782014-05-19 15:00:07 -07003[Full documentation](http://google.github.io/google-api-python-client)
John Asmuth2fefc4c2014-04-24 16:13:05 -04004
Joe Gregorio8097e2a2011-05-17 11:11:34 -04005
Joe Gregorio48d361f2010-08-18 13:19:21 -04006Installation
7============
8
Craig Citro3f8dc782014-05-19 15:00:07 -07009To install, simply use `pip` or `easy_install`:
Joe Gregorio46675d22012-06-20 12:15:24 -040010
Craig Citro4cc527f2014-05-19 15:01:17 -070011 $ pip install --upgrade google-api-python-client
Joe Gregorio48d361f2010-08-18 13:19:21 -040012
Craig Citro4cc527f2014-05-19 15:01:17 -070013or
14
15 $ easy_install --upgrade google-api-python-client
Tom Miller7c95d812010-10-11 11:50:52 -070016
Craig Citro3f8dc782014-05-19 15:00:07 -070017See the
18[Developers Guide](https://developers.google.com/api-client-library/python/start/get_started)
19for more detailed instructions and documentation.
Joe Gregorio48d361f2010-08-18 13:19:21 -040020
Tom Miller3a49e4c2010-09-28 15:16:25 -070021Third Party Libraries
Joe Gregorioe9e236f2011-03-21 22:23:14 -040022=====================
23
Joe Gregorio20a5aa92011-04-01 17:44:25 -040024These libraries will be installed when you install the client library:
Joe Gregorio48d361f2010-08-18 13:19:21 -040025
Craig Citro3f8dc782014-05-19 15:00:07 -070026* http://code.google.com/p/httplib2
27* http://code.google.com/p/uri-templates
Joe Gregorio8097e2a2011-05-17 11:11:34 -040028
29Depending on your version of Python, these libraries may also be installed:
30
Craig Citro3f8dc782014-05-19 15:00:07 -070031* http://pypi.python.org/pypi/simplejson/
Joe Gregorio432f17e2011-05-22 23:18:00 -040032
Joe Gregorio7accf7a2011-10-14 12:07:20 -040033For development you will also need:
Joe Gregorio432f17e2011-05-22 23:18:00 -040034
Craig Citro3f8dc782014-05-19 15:00:07 -070035* http://pythonpaste.org/webtest/
36
37Contributing
38============
39
40Please see the
41[contributing page](http://google.github.io/google-api-python-client/contributing.html)
42for more information. In particular, we love pull requests -- but please make
43sure to sign the contributor license agreement.