🐍 The official Python client library for Google's discovery based APIs.
Python Other
Clone or download
Failed to load latest commit information.
.github Update issue tracker to link to g suite public issue trackers (#475) Feb 2, 2018
apiclient Make apiclient.sample_tools optional (#525) Jun 4, 2018
docs Handle unknown media length (#406) Jan 16, 2018
googleapiclient add copyright header, closes #216 (#550) Jul 26, 2018
samples prevent stray imports of older 'apiclient' alias from raising an Impo… Jul 17, 2018
tests Respect custom headers set on the request supplied to MediaIoBaseDown… Jul 19, 2018
tools Version 1.3 release. Oct 15, 2014
.coveragerc Adding coveralls integration Mar 30, 2015
.gitignore Adding coveralls integration Mar 30, 2015
.gitmodules Drop oauth2client as a submodule. Oct 9, 2014
.hgignore Adding Python DFA Reporting API Samples. Nov 18, 2013
.travis.yml Match travis matrix with tox testenv (#498) Apr 27, 2018
CHANGELOG Release google-api-python-client 1.7.4 (#540) Jul 11, 2018
CODE_OF_CONDUCT.md Add Code of Conduct Jul 2, 2018
LICENSE Version 1.3 release. Oct 15, 2014
MANIFEST.in Include tests in source distribution (#514) May 31, 2018
Makefile Use twine to upload the package to pypi. Sep 11, 2015
README.md Better docs links in readme (#544) Jul 17, 2018
describe.py Fix method doc signatures for multiline required parameters (#374) Mar 27, 2017
expandsymlinks.py Replace remaining python2.4 shebang lines. Mar 2, 2015
samples-index.py 2to3 -f print Nov 8, 2014
setup.py Remove unnecessary check during setup (#518) Jun 1, 2018
sitecustomize.py Transition apiclient from googlecode to github. Apr 24, 2014
tox.ini Remove unused keyring test dependency (#496) Apr 23, 2018


Google API Client

This is the Python client library for Google's discovery based APIs. To get started, please see the full documentation for this library. Additionally, dynamically generated documentation is available for all of the APIs supported by this library.

These 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.

Google Cloud Platform

For Google Cloud Platform APIs such as Datastore, Cloud Storage or Pub/Sub, we recommend using Cloud Client Libraries for Python which is under active development.


To install, simply use pip or easy_install:

$ pip install --upgrade google-api-python-client


$ easy_install --upgrade google-api-python-client

See the Developers Guide for more detailed instructions and additional documentation.

Python Version

Python 2.7, 3.4, 3.5, and 3.6 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.

Third Party Libraries and Dependencies

The following libraries will be installed when you install the client library:

For development you will also need the following libraries:


Please see the contributing page for more information. In particular, we love pull requests - but please make sure to sign the contributor license agreement.