chore: Update discovery artifacts (#1725)

## Deleted keys were detected in the following stable discovery artifacts:
artifactregistry v1 https://github.com/googleapis/google-api-python-client/commit/48c242e82ff838cd80e637e1c2b1c48d5fe534af
run v2 https://github.com/googleapis/google-api-python-client/commit/54d02182818eeda0ef7dec22545c477673232b59

## Deleted keys were detected in the following pre-stable discovery artifacts:
firebaseappcheck v1beta https://github.com/googleapis/google-api-python-client/commit/6e26f5ce4c0499d4def8ea4521888b8f2d18c041
gkehub v1alpha https://github.com/googleapis/google-api-python-client/commit/bbad5a0e28e5d7daa9bbeb2f9c853708107424a7
gkehub v1beta https://github.com/googleapis/google-api-python-client/commit/bbad5a0e28e5d7daa9bbeb2f9c853708107424a7
gkehub v2alpha https://github.com/googleapis/google-api-python-client/commit/bbad5a0e28e5d7daa9bbeb2f9c853708107424a7
recommender v1beta1 https://github.com/googleapis/google-api-python-client/commit/43c8ed8720983495b1ca323ccdc7de18ca455c44

## Discovery Artifact Change Summary:
feat(alertcenter): update the api https://github.com/googleapis/google-api-python-client/commit/49ea8e87b69ab39ec37af1e2ee40ded99c8a9863
feat(apigee): update the api https://github.com/googleapis/google-api-python-client/commit/6cd7b462fbfa2655118f8cb541c12a77d529190c
feat(artifactregistry): update the api https://github.com/googleapis/google-api-python-client/commit/48c242e82ff838cd80e637e1c2b1c48d5fe534af
feat(baremetalsolution): update the api https://github.com/googleapis/google-api-python-client/commit/93195a6a493707707186a3e410a04990e26a0d3b
feat(dataflow): update the api https://github.com/googleapis/google-api-python-client/commit/bcd6ea147ab3fda1c2a992ce3e026e19bdeeb799
fix(deploymentmanager): update the api https://github.com/googleapis/google-api-python-client/commit/8b2964fa504b3fa765822d838ce95ac15f96442a
feat(dialogflow): update the api https://github.com/googleapis/google-api-python-client/commit/39cd4bde6cba0b8af12ce645552899cd6d8afa37
feat(fcm): update the api https://github.com/googleapis/google-api-python-client/commit/d9a7eb4fcd54b754bac2e19b97ef5db7603d42ce
feat(firebaseappcheck): update the api https://github.com/googleapis/google-api-python-client/commit/6e26f5ce4c0499d4def8ea4521888b8f2d18c041
feat(gkehub): update the api https://github.com/googleapis/google-api-python-client/commit/bbad5a0e28e5d7daa9bbeb2f9c853708107424a7
feat(healthcare): update the api https://github.com/googleapis/google-api-python-client/commit/eba1e3a3bc4477b5731ced542b5ff81ea987505a
feat(mybusinessverifications): update the api https://github.com/googleapis/google-api-python-client/commit/78fb94ecef8b9d3c44850eb808f9f10973a907f1
feat(networkmanagement): update the api https://github.com/googleapis/google-api-python-client/commit/07dcadcc737b22861ab5ad05c4bfc096ba71f438
feat(networkservices): update the api https://github.com/googleapis/google-api-python-client/commit/3d03ad1c7a2652bf5d47d9e09f791b1da14e3b02
feat(notebooks): update the api https://github.com/googleapis/google-api-python-client/commit/3a26ea7a6578d9226ed4c8e13951800ad8d7d2a7
feat(recommender): update the api https://github.com/googleapis/google-api-python-client/commit/43c8ed8720983495b1ca323ccdc7de18ca455c44
feat(retail): update the api https://github.com/googleapis/google-api-python-client/commit/3b229064b4404751ea5c00e8b569b1389276aff9
feat(run): update the api https://github.com/googleapis/google-api-python-client/commit/54d02182818eeda0ef7dec22545c477673232b59
feat(versionhistory): update the api https://github.com/googleapis/google-api-python-client/commit/657ba28422aac6f19b155df1384ceb5bdaf4ff11
feat(vmmigration): update the api https://github.com/googleapis/google-api-python-client/commit/00aa6fc010336c0ac75ccc21933e89560e8b18ca
feat(youtube): update the api https://github.com/googleapis/google-api-python-client/commit/d236f3ae7a44b9018a1690e12b25c0cb0e2828a1
482 files changed
tree: f17c56ef4099b6abdee36c936e485ff368169ffb
  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. .trampolinerc
  17. CHANGELOG.md
  18. CODE_OF_CONDUCT.md
  19. CONTRIBUTING.rst
  20. describe.py
  21. expandsymlinks.py
  22. LICENSE
  23. Makefile
  24. MANIFEST.in
  25. noxfile.py
  26. owlbot.py
  27. README.md
  28. renovate.json
  29. samples-index.py
  30. SECURITY.md
  31. setup.cfg
  32. setup.py
  33. sitecustomize.py
  34. 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, 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.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.