Skip to content

googleapis/google-api-python-client

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

## Deleted keys were detected in the following stable discovery artifacts:
chat v1 https://togithub.com/googleapis/google-api-python-client/commit/f9d3cb6e430faeb9b942b42de748efa166509f57
cloudsearch v1 https://togithub.com/googleapis/google-api-python-client/commit/e602008ba98c9c4daf5b68d4308fa99f47e4fee4
documentai v1 https://togithub.com/googleapis/google-api-python-client/commit/79ca84ab16a8cde17cdc0293c27f0e72b9cde5d5

## Discovery Artifact Change Summary:
feat(androidmanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/2dd64637ec67d4802fdee296a9c178cacf22d0d8
feat(chat): update the api https://togithub.com/googleapis/google-api-python-client/commit/f9d3cb6e430faeb9b942b42de748efa166509f57
feat(cloudasset): update the api https://togithub.com/googleapis/google-api-python-client/commit/89473b2ca0e27fae3d1c6d7f92e16933f2829c88
feat(cloudsearch): update the api https://togithub.com/googleapis/google-api-python-client/commit/e602008ba98c9c4daf5b68d4308fa99f47e4fee4
feat(composer): update the api https://togithub.com/googleapis/google-api-python-client/commit/626bf19259ba4717090b182ca20ad13b6acf40b3
feat(contactcenterinsights): update the api https://togithub.com/googleapis/google-api-python-client/commit/ebb648aa643aad895798ff1aa58e051e2dd06bad
feat(container): update the api https://togithub.com/googleapis/google-api-python-client/commit/9ccf94909892076fb071c1e79e10ea0973c49d71
feat(datapipelines): update the api https://togithub.com/googleapis/google-api-python-client/commit/1dadbf77eea1fc5538643f876e7cecf36acc9318
feat(dataplex): update the api https://togithub.com/googleapis/google-api-python-client/commit/2d0cd12f1711e71e58e1835341e269e339096e63
feat(dns): update the api https://togithub.com/googleapis/google-api-python-client/commit/c250e0e81554847ba62d663c3f3020aa677701b8
feat(documentai): update the api https://togithub.com/googleapis/google-api-python-client/commit/79ca84ab16a8cde17cdc0293c27f0e72b9cde5d5
feat(securitycenter): update the api https://togithub.com/googleapis/google-api-python-client/commit/86e1526a1de990a72eda1e52c2df8078b48fc973
feat(serviceconsumermanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/51e6ed6970b305f0225d5fd07e0aa9fb776ffd02
feat(servicenetworking): update the api https://togithub.com/googleapis/google-api-python-client/commit/3130518d7a1c2f3f787a1a9cbdd23c3018de8f59
feat(serviceusage): update the api https://togithub.com/googleapis/google-api-python-client/commit/7475ad606bad6f0fe5b8c95530e943df3ef322c8
feat(testing): update the api https://togithub.com/googleapis/google-api-python-client/commit/a456ae80c81a8a0baea7f3871dfc56cee625dd05
9b5767f

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time

Google API Client

PyPI version

This is the Google API Python client library for Google's discovery based APIs. To get started, please see the docs 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 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.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+ in v1.

Discovery documents will no longer be retrieved dynamically when you call discovery.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 the Migration Guide for more information.

Documentation

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.

Installation

Install this library in a virtualenv using 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/Linux

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

Windows

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

Supported Python Versions

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

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:

Contributing

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