Skip to content
Switch branches/tags

Latest commit

## Deleted keys were detected in the following stable discovery artifacts:
displayvideo v1 c32bbe5
firestore v1 a5f3d2f

## Discovery Artifact Change Summary:
feat(apigee): update the api 03592f8
feat(apikeys): update the api f667d8c
feat(baremetalsolution): update the api 74787f2
feat(datastore): update the api c573fc2
feat(dialogflow): update the api 4d96721
feat(displayvideo): update the api c32bbe5
feat(documentai): update the api 62b8d0d
feat(firestore): update the api a5f3d2f
feat(healthcare): update the api 633c51d
feat(metastore): update the api f116213
feat(monitoring): update the api 2c2d15d
feat(retail): update the api 6a362da
feat(secretmanager): update the api be08227
feat(sqladmin): update the api 31c607e

Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Google API Client

PyPI version



This library is officially supported by Google. However, the maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development. For more information, please visit Client Libraries Explained.

Version 2.0 Release

The 2.0 release of google-api-python-client includes a substantial reliability improvement, compared with 1.x, as discovery documents are now cached in the library rather than fetched dynamically. It is highly recommended to upgrade from v1.x to v2.x.

Only python 3.6 and newer is supported. If you are not able to upgrade python, then please continue to use version 1.x as we will continue supporting python 2.7+ in v1.

Discovery documents will no longer be retrieved dynamically when you call The discovery documents will instead be retrieved from the client library directly. New versions of this library are released weekly. As a result of caching the discovery documents, the size of this package is at least 50 MB larger compared to the previous version.

Please see the Migration Guide for more information.


See the docs folder for more detailed instructions and additional documentation.

Other Google API libraries

The maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development due to the following reasons:

With Cloud Client Libraries for Python:

  • There is a separate client library for each API, so you can choose which client libraries to download. Whereas, google-api-python-client is a single client library for all APIs. As a result, the total package size for google-api-python-client exceeds 50MB.
  • There are stricter controls for breaking changes to the underlying APIs as each client library is focused on a specific API.
  • There are more features in these Cloud Client Libraries as each library is focused on a specific API, and in some cases, the libraries are owned by team who specialized in that API.
  • Developers will benefit from intellisense.

For more information, please visit Client Libraries Explained.

Although there are many benefits to moving to Cloud Client Libraries for Python, the maintainers want to emphasize that google-api-python-client will continue to be supported.

For Google Ads API, we recommend using Google Ads API Client Library for Python.

For Google Firebase Admin API, we recommend using Firebase Admin Python SDK.



With virtualenv, it's possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.


pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-api-python-client


pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\pip.exe install google-api-python-client

Supported Python Versions

Python 3.6, 3.7, 3.8, 3.9 and 3.10 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.

Unsupported Python Versions

Python < 3.6

Third Party Libraries and Dependencies


For development you will also need the following libraries:


Please see our Contribution Guide. In particular, we love pull requests - but please make sure to sign the contributor license agreement.