Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / f0b025b95b2fb5fd0369d7233614e35b9c86af30 / . / README.md
blob: e9a96a606f36570e6e3f2abe2a788f66586b7a5c [file] [log] [blame] [view]
Matt Whisenhunt3c2c8052018-04-13 10:03:46 -0700[diff] [blame]1# Google API Client
Dan O'Meara9c203d32017-07-07 09:03:31 -0700[diff] [blame]2
Sander Brauwers729d9ae2018-12-13 19:28:04 +0100[diff] [blame]3[![PyPI version](https://badge.fury.io/py/google-api-python-client.svg)](https://badge.fury.io/py/google-api-python-client)
4
Bu Sun Kimc9773042019-07-17 14:03:17 -0700[diff] [blame]5This is the Python client library for Google's discovery based APIs. To get started, please see the [docs folder](docs/README.md).
John Asmuth2fefc4c2014-04-24 16:13:05 -0400[diff] [blame]6
Matt Whisenhunt3c2c8052018-04-13 10:03:46 -0700[diff] [blame]7These client libraries are officially supported by Google. However, the libraries are considered complete and are in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.
8
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]9## Documentation
10
11See the [docs folder](docs/README.md) for more detailed instructions and additional documentation.
12
Matt Whisenhunt3c2c8052018-04-13 10:03:46 -0700[diff] [blame]13## Google Cloud Platform
14
15For Google Cloud Platform APIs such as Datastore, Cloud Storage or Pub/Sub, we recommend using [Cloud Client Libraries for Python](https://github.com/GoogleCloudPlatform/google-cloud-python) which is under active development.
Joe Gregorio8097e2a2011-05-17 11:11:34 -0400[diff] [blame]16
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]17## Installation
18
Craig Citro3f8dc782014-05-19 15:00:07 -0700[diff] [blame]19To install, simply use `pip` or `easy_install`:
Joe Gregorio46675d22012-06-20 12:15:24 -0400[diff] [blame]20
Michael Mattiolib2b518f2014-07-14 00:48:04 -0400[diff] [blame]21```bash
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]22pip install --upgrade google-api-python-client
Michael Mattiolib2b518f2014-07-14 00:48:04 -0400[diff] [blame]23```
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]24
Craig Citro4cc527f2014-05-19 15:01:17 -0700[diff] [blame]25or
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]26
Michael Mattiolib2b518f2014-07-14 00:48:04 -0400[diff] [blame]27```bash
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]28easy_install --upgrade google-api-python-client
Michael Mattiolib2b518f2014-07-14 00:48:04 -0400[diff] [blame]29```
Tom Miller7c95d812010-10-11 11:50:52 -0700[diff] [blame]30
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]31## Supported Python Versions
Joe Gregorio48d361f2010-08-18 13:19:21 -0400[diff] [blame]32
Christopher Wilcox8f4a5302018-12-14 12:24:44 -0800[diff] [blame]33Python 3.4, 3.5, 3.6 and 3.7 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions
34
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]35## Deprecated Python Versions
36
Christopher Wilcox8f4a5302018-12-14 12:24:44 -0800[diff] [blame]37Python == 2.7
Jay Lee9cd0eb02014-09-12 07:15:11 -0400[diff] [blame]38
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]39## Third Party Libraries and Dependencies
40
Michael Mattiolib2b518f2014-07-14 00:48:04 -0400[diff] [blame]41The following libraries will be installed when you install the client library:
Luis Nell4859b142016-08-01 18:43:35 +0200[diff] [blame]42* [httplib2](https://github.com/httplib2/httplib2)
Simon Weberc952fd02016-10-13 12:48:44 -0400[diff] [blame]43* [uritemplate](https://github.com/sigmavirus24/uritemplate)
Joe Gregorio8097e2a2011-05-17 11:11:34 -0400[diff] [blame]44
Michael Mattioli460a4ad2014-08-01 21:37:56 -0400[diff] [blame]45For development you will also need the following libraries:
andrewnester31677812017-03-31 16:39:30 +0300[diff] [blame]46* [WebTest](http://webtest.pythonpaste.org/en/latest/index.html)
Michael Mattioli460a4ad2014-08-01 21:37:56 -0400[diff] [blame]47* [pycrypto](https://pypi.python.org/pypi/pycrypto)
48* [pyopenssl](https://pypi.python.org/pypi/pyOpenSSL)
Craig Citro3f8dc782014-05-19 15:00:07 -0700[diff] [blame]49
Grant Timmerman5c11b0a2019-06-26 07:39:48 -0700[diff] [blame]50## Contributing
51
Jay Lee9cd0eb02014-09-12 07:15:11 -0400[diff] [blame]52Please see the [contributing page](http://google.github.io/google-api-python-client/contributing.html) for more information. In particular, we love pull requests - but please make sure to sign the contributor license agreement.