• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Google API Client
2
3[![PyPI version](https://badge.fury.io/py/google-api-python-client.svg)](https://badge.fury.io/py/google-api-python-client)
4[![Compat check PyPI](https://python-compatibility-tools.appspot.com/one_badge_image?package=google-api-python-client)](https://python-compatibility-tools.appspot.com/one_badge_target?package=google-api-python-client)
5[![Compat check github](https://python-compatibility-tools.appspot.com/one_badge_image?package=git%2Bgit%3A//github.com/googleapis/google-api-python-client.git)](https://python-compatibility-tools.appspot.com/one_badge_target?package=git%2Bgit%3A//github.com/googleapis/google-api-python-client.git)
6
7This is the Python client library for Google's discovery based APIs. To get started, please see the [docs folder](docs/README.md).
8
9These 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.
10
11## Documentation
12
13See the [docs folder](docs/README.md) for more detailed instructions and additional documentation.
14
15## Google Cloud Platform
16
17For 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.
18
19## Installation
20
21To install, simply use `pip` or `easy_install`:
22
23```bash
24pip install --upgrade google-api-python-client
25```
26
27or
28
29```bash
30easy_install --upgrade google-api-python-client
31```
32
33## Supported Python Versions
34
35Python 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
36
37## Deprecated Python Versions
38
39Python == 2.7
40
41## Third Party Libraries and Dependencies
42
43The following libraries will be installed when you install the client library:
44* [httplib2](https://github.com/httplib2/httplib2)
45* [uritemplate](https://github.com/sigmavirus24/uritemplate)
46
47For development you will also need the following libraries:
48* [WebTest](http://webtest.pythonpaste.org/en/latest/index.html)
49* [pycrypto](https://pypi.python.org/pypi/pycrypto)
50* [pyopenssl](https://pypi.python.org/pypi/pyOpenSSL)
51
52## Contributing
53
54Please 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.
55