Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / a933dad7e72d3093be480ce6af3965f41db1d193
commita933dad7e72d3093be480ce6af3965f41db1d193[log] [tgz]
authoryoshi-code-bot <70984784+yoshi-code-bot@users.noreply.github.com>Tue Jul 06 00:26:24 2021 -0700
committerGitHub <noreply@github.com>Tue Jul 06 07:26:24 2021 +0000
tree5180b45fa07d0eff60a83281ea70c85cf5041bbb
parent58ba61d8923a2d3898b6190190c746263a349c2b [diff]
chore: Update discovery artifacts (#1430)

## Deleted keys were detected in the following pre-stable discovery artifacts:
run v1alpha1 https://github.com/googleapis/google-api-python-client/commit/db18e29c7f616f212121960fe8efd6fb7cdf9b22

## Discovery Artifact Change Summary:
feat(artifactregistry): update the api https://github.com/googleapis/google-api-python-client/commit/bc9a38bf901a63525fb4c7b1e94fd4ce5fb441c3
feat(chat): update the api https://github.com/googleapis/google-api-python-client/commit/eea3c5c177aaded427fd3b5bab80812bf748ef79
feat(cloudasset): update the api https://github.com/googleapis/google-api-python-client/commit/2e31dd0b58d3c656df5aaa042994c637d0100f97
feat(cloudbuild): update the api https://github.com/googleapis/google-api-python-client/commit/3a3b420d53aabe1fdf6ddca483a3d164f72d6268
feat(composer): update the api https://github.com/googleapis/google-api-python-client/commit/78c0d8decbe640c522c45850c97002e7da12f4e0
feat(container): update the api https://github.com/googleapis/google-api-python-client/commit/a54737fe763fd288e54505faace58040cbf8920b
feat(datafusion): update the api https://github.com/googleapis/google-api-python-client/commit/f6bf3c6b92fbf7072798b987998bf55ee9276389
feat(dataproc): update the api https://github.com/googleapis/google-api-python-client/commit/3fde9a3604e4811ce02f1062dcee9cef35b1ad51
feat(documentai): update the api https://github.com/googleapis/google-api-python-client/commit/79c556d389889fb0f48c8cc5ad5ab4a2caaab603
feat(groupssettings): update the api https://github.com/googleapis/google-api-python-client/commit/d537f96a20a699629fa85fbdeadb74ead3b32699
feat(logging): update the api https://github.com/googleapis/google-api-python-client/commit/d3548c505e4b1065365584493d15f21a19639626
feat(monitoring): update the api https://github.com/googleapis/google-api-python-client/commit/d24af68a9621fda9d7a576d3615178604a1482d2
feat(paymentsresellersubscription): update the api https://github.com/googleapis/google-api-python-client/commit/cff9039529278d95cee936826b5406867c638430
feat(redis): update the api https://github.com/googleapis/google-api-python-client/commit/46102d1726393f872420820e6200bb83cefd74b6
feat(run): update the api https://github.com/googleapis/google-api-python-client/commit/db18e29c7f616f212121960fe8efd6fb7cdf9b22
feat(slides): update the api https://github.com/googleapis/google-api-python-client/commit/68634cd565914e6003c851ec5f43fa2ff290afca
feat(spanner): update the api https://github.com/googleapis/google-api-python-client/commit/289512124fc77a69957b912f06e9c3d315aa0526
feat(storagetransfer): update the api https://github.com/googleapis/google-api-python-client/commit/24895f156f10c03f2da686be95d8c70ea34008a3
330 files changed
tree: 5180b45fa07d0eff60a83281ea70c85cf5041bbb
  1. .github/
  2. .kokoro/
  3. apiclient/
  4. docs/
  5. googleapiclient/
  6. samples/
  7. scripts/
  8. testing/
  9. tests/
  10. tools/
  11. .coveragerc
  12. .gitignore
  13. .gitmodules
  14. .hgignore
  15. .repo-metadata.json
  16. CHANGELOG.md
  17. CODE_OF_CONDUCT.md
  18. CONTRIBUTING.rst
  19. describe.py
  20. expandsymlinks.py
  21. LICENSE
  22. Makefile
  23. MANIFEST.in
  24. noxfile.py
  25. owlbot.py
  26. README.md
  27. renovate.json
  28. samples-index.py
  29. SECURITY.md
  30. setup.cfg
  31. setup.py
  32. sitecustomize.py
  33. UPGRADING.md
README.md

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 is a significant upgrade compared to v1. Please see the Migration Guide for more information. As a result of caching the discovery documents, the size of this package is at least 50 MB larger compared to the previous version.

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

pip 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.6, 3.7, 3.8, and 3.9 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.6

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.