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/2ebbbba9e1ceac8db6b3a90e56d00bad3c6183c5
displayvideo v2 https://togithub.com/googleapis/google-api-python-client/commit/1a3f64b4fd8e4f1774e1c6e6a70ad91a5a550590

## Deleted keys were detected in the following pre-stable discovery artifacts:
compute alpha https://togithub.com/googleapis/google-api-python-client/commit/2a5e985835d9e6a6eff7d88c2d8aac08fa4677df
gamesConfiguration v1configuration https://togithub.com/googleapis/google-api-python-client/commit/5e1872ea1691596119064e2d09043a99c15adac3

## Discovery Artifact Change Summary:
feat(analyticsadmin): update the api https://togithub.com/googleapis/google-api-python-client/commit/1277148ed4bb16c03802a6d11bb15ab138bf6c19
feat(assuredworkloads): update the api https://togithub.com/googleapis/google-api-python-client/commit/0777a539623f6a0e5c0ee8a0014c49797e14a826
feat(baremetalsolution): update the api https://togithub.com/googleapis/google-api-python-client/commit/21f9266331d46ae55a4749d485d5937797d75c03
feat(chat): update the api https://togithub.com/googleapis/google-api-python-client/commit/42d7975db499e1298a45b5d7ea086dddbfd3e5ec
feat(cloudfunctions): update the api https://togithub.com/googleapis/google-api-python-client/commit/27456f04a82bd30a897822da45adba98b00d0b73
feat(cloudsearch): update the api https://togithub.com/googleapis/google-api-python-client/commit/2ebbbba9e1ceac8db6b3a90e56d00bad3c6183c5
feat(cloudsupport): update the api https://togithub.com/googleapis/google-api-python-client/commit/660300bb6094cdafa87016f16becc956489d723f
feat(composer): update the api https://togithub.com/googleapis/google-api-python-client/commit/b223e46fa38d9cabcf81b66ca78e9b1d4e88c01b
feat(compute): update the api https://togithub.com/googleapis/google-api-python-client/commit/2a5e985835d9e6a6eff7d88c2d8aac08fa4677df
feat(content): update the api https://togithub.com/googleapis/google-api-python-client/commit/93233da7ebde3542aaa004402c77bc19e6c919be
feat(dataplex): update the api https://togithub.com/googleapis/google-api-python-client/commit/714d395fa712c56f1d207e4408ca1a252fd3d162
feat(dialogflow): update the api https://togithub.com/googleapis/google-api-python-client/commit/1d14a2f69b29855ec25b488babfbceb0609a519c
feat(displayvideo): update the api https://togithub.com/googleapis/google-api-python-client/commit/1a3f64b4fd8e4f1774e1c6e6a70ad91a5a550590
feat(gamesConfiguration): update the api https://togithub.com/googleapis/google-api-python-client/commit/5e1872ea1691596119064e2d09043a99c15adac3
feat(metastore): update the api https://togithub.com/googleapis/google-api-python-client/commit/eba8d4f0e129812a600e4e8e6c33f4ab88c95180
feat(networkmanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/c65d33b8ca6b2aa014bc39bd4ca32ed1e9ebd96c
feat(paymentsresellersubscription): update the api https://togithub.com/googleapis/google-api-python-client/commit/fd60e1157653d8b018ac093b01a32d3434148df4
feat(securitycenter): update the api https://togithub.com/googleapis/google-api-python-client/commit/c0c746a361421b6d250817f4d397d2c34dc2c4e9
feat(servicemanagement): update the api https://togithub.com/googleapis/google-api-python-client/commit/e3f20cd1141dd5ca47b2323eb0fa029e255c78ec
feat(spanner): update the api https://togithub.com/googleapis/google-api-python-client/commit/c2007c17ae0eb31027417903a034dbc98eade638
feat(texttospeech): update the api https://togithub.com/googleapis/google-api-python-client/commit/bb64e3c504126472671203b1affec77396db89e7
feat(vmmigration): update the api https://togithub.com/googleapis/google-api-python-client/commit/3e1a2c94e7c20c7fef3f746bf40f74c06b7c2e29
fa65fca

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.