Package: google-api-python-client
Google API ClientThis is theGoogle API Python client libraryfor Google's discovery based APIs. To get started, please see thedocs folder.This library is considered complete and is in maintenance mode. This means
that we will address critical bugs and security issues but will not add any
new features.This library is officially supported by Google.  However, the maintainers of
this repository recommend usingCloud Client Libraries for Python,
where possible, for new code development. For more information, please visitClient Libraries Explained.Version 2.0 ReleaseThe 2.0 release ofgoogle-api-python-clientincludes 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.7 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+ inv1.Discovery documents will no longer be retrieved dynamically when
you calldiscovery.build(). 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 theMigration Guidefor more information.DocumentationSee thedocs folderfor more detailed instructions and additional documentation.Other Google API librariesThe maintainers of this repository recommend usingCloud Client Libraries for Python,
where possible, for new code development due to the following reasons:WithCloud 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-clientis a
single client library for all APIs. As a result, the total package size forgoogle-api-python-clientexceeds 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 visitClient Libraries Explained.Although there are many benefits to moving toCloud Client Libraries for Python,
the maintainers want to emphasize thatgoogle-api-python-clientwill continue
to be supported.For Google Ads API, we recommend usingGoogle Ads API Client Library for Python.For Google Firebase Admin API, we recommend usingFirebase Admin Python SDK.InstallationInstall this library in avirtualenvusing pip. virtualenv is a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.With virtualenv, it's possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies.Mac/Linuxpip3 install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-api-python-clientWindowspip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-api-python-clientSupported Python VersionsPython 3.7, 3.8, 3.9, 3.10, 3.11 and 3.12 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 VersionsPython < 3.7Third Party Libraries and DependenciesThe following libraries will be installed when you install the client library:httplib2uritemplateFor development you will also need the following libraries:WebTestpyopensslContributingPlease see ourContribution Guide.
In particular, we love pull requests - but please make sure to sign
the contributor license agreement.