Skip to content

googleapis/google-api-python-client

main
Switch branches/tags
Code

Latest commit

## Deleted keys were detected in the following stable discovery artifacts:
chromepolicy v1 https://togithub.com/googleapis/google-api-python-client/commit/f2478699397d683731136325d64d038abb8c0de6
cloudsearch v1 https://togithub.com/googleapis/google-api-python-client/commit/fc29ead2fdfb4273cdc00cb7bd3f09dd50e37f51

## Deleted keys were detected in the following pre-stable discovery artifacts:
cloudtasks v2beta2 https://togithub.com/googleapis/google-api-python-client/commit/016214975099347cdc4870ce8e6d9b14bd2e7bd3
firebasestorage v1beta https://togithub.com/googleapis/google-api-python-client/commit/b4bda575312e64f6c3d007932533abdca1ef0210

## Discovery Artifact Change Summary:
feat(analyticsadmin): update the api https://togithub.com/googleapis/google-api-python-client/commit/efb691ee5e2fd19dcd8ce99b02b04dc8bd4b7df5
feat(assuredworkloads): update the api https://togithub.com/googleapis/google-api-python-client/commit/6c5991727e9d02381db21f857646e778cf54e0d4
feat(beyondcorp): update the api https://togithub.com/googleapis/google-api-python-client/commit/1bbd2aa828e53f9939afd0d8119d62c89228ec6a
feat(bigquery): update the api https://togithub.com/googleapis/google-api-python-client/commit/2ee419bab63b4a5984cab0636037cd3dcc1dd89e
feat(certificatemanager): update the api https://togithub.com/googleapis/google-api-python-client/commit/2fe105a191156da096820c0f2a0cbd725227e553
feat(chromemanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/ec3508a2f33e3b1965f3977b8f32c9be90363b97
feat(chromepolicy): update the api https://togithub.com/googleapis/google-api-python-client/commit/f2478699397d683731136325d64d038abb8c0de6
feat(cloudasset): update the api https://togithub.com/googleapis/google-api-python-client/commit/a40c120368e20ae5956d688006afe2597988aced
feat(cloudidentity): update the api https://togithub.com/googleapis/google-api-python-client/commit/8358d459d15087669fc9ecc691a4dca7b637df38
feat(cloudsearch): update the api https://togithub.com/googleapis/google-api-python-client/commit/fc29ead2fdfb4273cdc00cb7bd3f09dd50e37f51
feat(cloudtasks): update the api https://togithub.com/googleapis/google-api-python-client/commit/016214975099347cdc4870ce8e6d9b14bd2e7bd3
feat(compute): update the api https://togithub.com/googleapis/google-api-python-client/commit/703edfa4d3c78cbc184b190cc28214b0beb04f75
feat(containeranalysis): update the api https://togithub.com/googleapis/google-api-python-client/commit/404f0c97171a8ea968d7c04f350161729c5ea51b
feat(dataflow): update the api https://togithub.com/googleapis/google-api-python-client/commit/ff764b43fb1460be84361acd97d777524273902c
feat(documentai): update the api https://togithub.com/googleapis/google-api-python-client/commit/3c5cb8204cddde3e98a5d1f715f20c042088acfc
feat(driveactivity): update the api https://togithub.com/googleapis/google-api-python-client/commit/8be6614b72b681a129d4e63973ab825a88a5a860
feat(firebasestorage): update the api https://togithub.com/googleapis/google-api-python-client/commit/b4bda575312e64f6c3d007932533abdca1ef0210
feat(monitoring): update the api https://togithub.com/googleapis/google-api-python-client/commit/68d24a114ed9d8fdb71288d9e9699896a8c7e5a4
feat(paymentsresellersubscription): update the api https://togithub.com/googleapis/google-api-python-client/commit/3c1010ec174189184667846a5be38ebc491f7bd6
feat(playintegrity): update the api https://togithub.com/googleapis/google-api-python-client/commit/909483c18603a4ff6fb8f698cfdaea6dd180f098
feat(recommender): update the api https://togithub.com/googleapis/google-api-python-client/commit/359dea09eb0bed801549b18ce00829962d96da36
feat(retail): update the api https://togithub.com/googleapis/google-api-python-client/commit/fe492fe48af35dc21ce26029dac44a2606faf336
feat(spanner): update the api https://togithub.com/googleapis/google-api-python-client/commit/edc7eae706f45c562b01159f0bb6fa7338a27aba
3bf7830

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.