chore: Update discovery artifacts (#1516)

## Deleted keys were detected in the following stable discovery artifacts:
displayvideo v1 https://github.com/googleapis/google-api-python-client/commit/0ff4fae98fadd0e31eb09ff81656b87201d75d2b
file v1 https://github.com/googleapis/google-api-python-client/commit/ab13790877b89e112fd27b738462077c45408557

## Deleted keys were detected in the following pre-stable discovery artifacts:
compute alpha https://github.com/googleapis/google-api-python-client/commit/36050a3ad6fad1e5aec6c18085fbcad1564ceb1f
containeranalysis v1alpha1 https://github.com/googleapis/google-api-python-client/commit/e442b58fc9abfbbb37dc5b50cf17ba8dea508cba
file v1beta1 https://github.com/googleapis/google-api-python-client/commit/ab13790877b89e112fd27b738462077c45408557

## Discovery Artifact Change Summary:
fix(androidpublisher): update the api https://github.com/googleapis/google-api-python-client/commit/78ee7f700efa8d29a4a1ca3e23f1381c4d04c86a
feat(apigee): update the api https://github.com/googleapis/google-api-python-client/commit/59348e4809ff48906ffa356a0ecc867eb66376bd
feat(appengine): update the api https://github.com/googleapis/google-api-python-client/commit/a358ffd61a7671a7b3a90ccc329393feb80bc932
feat(bigquery): update the api https://github.com/googleapis/google-api-python-client/commit/fe54736e2583dd4f9efefa8fb5a6378741d6bf87
feat(cloudasset): update the api https://github.com/googleapis/google-api-python-client/commit/5b89c7b9eb3abee497fac27f2ba12208b257240f
feat(compute): update the api https://github.com/googleapis/google-api-python-client/commit/36050a3ad6fad1e5aec6c18085fbcad1564ceb1f
feat(contactcenterinsights): update the api https://github.com/googleapis/google-api-python-client/commit/c5bac63feeadd4cccc635d69af7e0f32a5df5bc3
feat(container): update the api https://github.com/googleapis/google-api-python-client/commit/3f4ac75311743c0b3e77647f3085374b5d898d01
feat(containeranalysis): update the api https://github.com/googleapis/google-api-python-client/commit/e442b58fc9abfbbb37dc5b50cf17ba8dea508cba
feat(displayvideo): update the api https://github.com/googleapis/google-api-python-client/commit/0ff4fae98fadd0e31eb09ff81656b87201d75d2b
feat(documentai): update the api https://github.com/googleapis/google-api-python-client/commit/4b0a7ed0cbef5031f7df162e8aa7629ba9073dc3
feat(file): update the api https://github.com/googleapis/google-api-python-client/commit/ab13790877b89e112fd27b738462077c45408557
feat(gkehub): update the api https://github.com/googleapis/google-api-python-client/commit/b168cc69436840e8c9a170863b13a4db253b9f5c
feat(iam): update the api https://github.com/googleapis/google-api-python-client/commit/88ebba5edbeb6dab547a6c57541f13dd13b95e23
feat(jobs): update the api https://github.com/googleapis/google-api-python-client/commit/eaffca049c02851d7c1b3a795d901e60616430df
feat(managedidentities): update the api https://github.com/googleapis/google-api-python-client/commit/ad3f2c91960b905126ae47c0777b27704aa02c64
feat(monitoring): update the api https://github.com/googleapis/google-api-python-client/commit/7317835fe784c723ed6e290ab3da515b68a25c5f
feat(prod_tt_sasportal): update the api https://github.com/googleapis/google-api-python-client/commit/ec0c06297952f922adfa6b4c265577846d2493d0
feat(recaptchaenterprise): update the api https://github.com/googleapis/google-api-python-client/commit/234d3f983a92fca973fcc42bf8e69e470f50fef5
feat(sqladmin): update the api https://github.com/googleapis/google-api-python-client/commit/f30d144526f01a5a69832166d4271b2288fdabad
343 files changed
tree: 217b20c34deebaac953dff3b2e16f1fb78804a07
  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.