Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / ad81f3da411eb38e48137cb67f22a718498bcdc1
commitad81f3da411eb38e48137cb67f22a718498bcdc1[log] [tgz]
authoryoshi-code-bot <70984784+yoshi-code-bot@users.noreply.github.com>Tue Sep 28 00:22:30 2021 -0700
committerGitHub <noreply@github.com>Tue Sep 28 07:22:30 2021 +0000
tree175dea39f30597221280126deb48deb3cddc6960
parent95be169f05cb7d5559dbdf4ae907fbf4f558273c [diff]
chore: Update discovery artifacts (#1541)

## Discovery Artifact Change Summary:
feat(analyticsadmin): update the api https://github.com/googleapis/google-api-python-client/commit/c14c42a82fbd61df00b690daa328cea212441f59
feat(appengine): update the api https://github.com/googleapis/google-api-python-client/commit/22e6b63271836d2b195191c0711d3e815d7b3f29
feat(bigquery): update the api https://github.com/googleapis/google-api-python-client/commit/5325b3654e42e393911f088e9a8358aeaf733c03
feat(content): update the api https://github.com/googleapis/google-api-python-client/commit/df08fb1f3823a5edc96e6caebe24df66e943fa36
feat(dialogflow): update the api https://github.com/googleapis/google-api-python-client/commit/eaa0b250682d593572168427d92b0c3b9438a503
feat(firestore): update the api https://github.com/googleapis/google-api-python-client/commit/89ee485ce0646fb14d4f4e1d7aae095e504cf4be
feat(gkehub): update the api https://github.com/googleapis/google-api-python-client/commit/982014c5e33c29f2e0030b950b2f2ac27afa3f8f
feat(monitoring): update the api https://github.com/googleapis/google-api-python-client/commit/440201ddeeae876ab83863def611ec39649d397c
fix(oslogin): update the api https://github.com/googleapis/google-api-python-client/commit/e940d95d04a6aba60b89ece3fd630cc0ab5cde2a
feat(retail): update the api https://github.com/googleapis/google-api-python-client/commit/58f1c1ba076ed6ecc389ddf66d0c5ac609cd9d17
feat(servicenetworking): update the api https://github.com/googleapis/google-api-python-client/commit/53d51411d39049a98df6909ae16f9c5dfee4f432
329 files changed
tree: 175dea39f30597221280126deb48deb3cddc6960
  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 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.6 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

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.