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:
cloudsearch v1 https://togithub.com/googleapis/google-api-python-client/commit/80826620580eaf4ae9fb63c44bf54a24191e53a6
contentwarehouse v1 https://togithub.com/googleapis/google-api-python-client/commit/512fa51cce00666c72f29a6a3757b3b6007674f8
documentai v1 https://togithub.com/googleapis/google-api-python-client/commit/26c82a3e3f909b727cb58762f290cfcd60d33ab2

## Deleted keys were detected in the following pre-stable discovery artifacts:
dataflow v1b3 https://togithub.com/googleapis/google-api-python-client/commit/ab7a6d7e2fda39c8565250ce96caecf3b9f14fa4
documentai v1beta2 https://togithub.com/googleapis/google-api-python-client/commit/26c82a3e3f909b727cb58762f290cfcd60d33ab2
documentai v1beta3 https://togithub.com/googleapis/google-api-python-client/commit/26c82a3e3f909b727cb58762f290cfcd60d33ab2
workstations v1beta https://togithub.com/googleapis/google-api-python-client/commit/45eeda302c12d58f236301495181a3171baa3d7d

## Discovery Artifact Change Summary:
feat(apigeeregistry): update the api https://togithub.com/googleapis/google-api-python-client/commit/f702bb4e4faa82165381dba609cfb8d7c9479d3a
feat(batch): update the api https://togithub.com/googleapis/google-api-python-client/commit/0157ea5c3f9c7f42fd566f003014886ac2fa4fe7
feat(bigqueryreservation): update the api https://togithub.com/googleapis/google-api-python-client/commit/58e81396e5c3fb59001d46d84cde9e1c16a49030
feat(chromemanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/e4108c28f970af0a79b8e6127a9bc4d122478b54
feat(cloudsearch): update the api https://togithub.com/googleapis/google-api-python-client/commit/80826620580eaf4ae9fb63c44bf54a24191e53a6
feat(compute): update the api https://togithub.com/googleapis/google-api-python-client/commit/33a044e4c2a5bf53d267ab26417cfcd26d9bf811
feat(contentwarehouse): update the api https://togithub.com/googleapis/google-api-python-client/commit/512fa51cce00666c72f29a6a3757b3b6007674f8
feat(dataflow): update the api https://togithub.com/googleapis/google-api-python-client/commit/ab7a6d7e2fda39c8565250ce96caecf3b9f14fa4
feat(documentai): update the api https://togithub.com/googleapis/google-api-python-client/commit/26c82a3e3f909b727cb58762f290cfcd60d33ab2
feat(file): update the api https://togithub.com/googleapis/google-api-python-client/commit/eb0b715c8b01774e772633ce6dbbcabf39a6fb4a
feat(gkehub): update the api https://togithub.com/googleapis/google-api-python-client/commit/f689940385089681592df0ce7ce02cd858ecab41
feat(integrations): update the api https://togithub.com/googleapis/google-api-python-client/commit/82639b51717b3f8a78a933fef8a5709ec092f73d
feat(mybusinessverifications): update the api https://togithub.com/googleapis/google-api-python-client/commit/9f4bdd4aaecc44ec317ce2da9dbe741cfcbc50e9
feat(retail): update the api https://togithub.com/googleapis/google-api-python-client/commit/9e87e6f70a79547bf1b6be9df2597b627faa4a5b
feat(sts): update the api https://togithub.com/googleapis/google-api-python-client/commit/3065b9285a9ea61e8f30e4e9875f48fb1f9b499b
feat(testing): update the api https://togithub.com/googleapis/google-api-python-client/commit/abf217f7519338f4a8304e4b8aaee7ac19e34488
feat(workflowexecutions): update the api https://togithub.com/googleapis/google-api-python-client/commit/bbe99d6ab5df7136b5bbe3a57ed5a03676a08759
feat(workstations): update the api https://togithub.com/googleapis/google-api-python-client/commit/45eeda302c12d58f236301495181a3171baa3d7d
ce9f358

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, 3.10 and 3.11 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.