codekingpro/portable-devtools
114k
1Metadata-Version: 2.12Name: google-api-python-client3Version: 2.127.04Summary: Google API Client Library for Python5Home-page: https://github.com/googleapis/google-api-python-client/6Author: Google LLC7Author-email: googleapis-packages@google.com8License: Apache 2.09Keywords: google api client10Classifier: Programming Language :: Python :: 311Classifier: Programming Language :: Python :: 3.712Classifier: Programming Language :: Python :: 3.813Classifier: Programming Language :: Python :: 3.914Classifier: Programming Language :: Python :: 3.1015Classifier: Programming Language :: Python :: 3.1116Classifier: Programming Language :: Python :: 3.1217Classifier: Development Status :: 5 - Production/Stable18Classifier: Intended Audience :: Developers19Classifier: License :: OSI Approved :: Apache Software License20Classifier: Operating System :: OS Independent21Classifier: Topic :: Internet :: WWW/HTTP22Requires-Python: >=3.723Description-Content-Type: text/markdown24License-File: LICENSE25Requires-Dist: httplib2 <1.dev0,>=0.19.026Requires-Dist: google-auth !=2.24.0,!=2.25.0,<3.0.0.dev0,>=1.32.027Requires-Dist: google-auth-httplib2 <1.0.0,>=0.2.028Requires-Dist: google-api-core !=2.0.*,!=2.1.*,!=2.2.*,!=2.3.0,<3.0.0.dev0,>=1.31.529Requires-Dist: uritemplate <5,>=3.0.130 31# Google API Client32 33[](https://badge.fury.io/py/google-api-python-client)34 35This is the [Google API Python client library](https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries)36for Google's discovery based APIs. To get started, please see the37[docs folder](https://github.com/googleapis/google-api-python-client/blob/main/docs/README.md).38 39This library is considered complete and is in maintenance mode. This means40that we will address critical bugs and security issues but will not add any41new features.42 43This library is officially supported by Google. However, the maintainers of44this repository recommend using [Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),45where possible, for new code development. For more information, please visit46[Client Libraries Explained](https://cloud.google.com/apis/docs/client-libraries-explained).47 48## Version 2.0 Release49The 2.0 release of `google-api-python-client` includes a substantial reliability 50improvement, compared with 1.x, as discovery documents are now cached in the library 51rather than fetched dynamically. It is highly recommended to upgrade from v1.x to v2.x.52 53Only python 3.7 and newer is supported. If you are not able to upgrade python, then54please continue to use version 1.x as we will continue supporting python 2.7+ in55[v1](https://github.com/googleapis/google-api-python-client/tree/v1).56 57Discovery documents will no longer be retrieved dynamically when58you call `discovery.build()`. The discovery documents will instead be retrieved59from the client library directly. New versions of this library are released weekly.60As a result of caching the discovery documents, the size of this package is at least 6150 MB larger compared to the previous version. 62 63Please see the [Migration Guide](https://github.com/googleapis/google-api-python-client/blob/main/UPGRADING.md)64for more information.65 66## Documentation67 68See the [docs folder](https://github.com/googleapis/google-api-python-client/blob/main/docs/README.md) for more detailed instructions and additional documentation.69 70## Other Google API libraries71 72The maintainers of this repository recommend using73[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),74where possible, for new code development due to the following reasons:75 76With [Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python):77- There is a separate client library for each API, so you can choose78which client libraries to download. Whereas, `google-api-python-client` is a79single client library for all APIs. As a result, the total package size for80`google-api-python-client` exceeds 50MB.81- There are stricter controls for breaking changes to the underlying APIs82as each client library is focused on a specific API.83- There are more features in these Cloud Client Libraries as each library is84focused on a specific API, and in some cases, the libraries are owned by team85who specialized in that API.86- Developers will benefit from intellisense.87 88For more information, please visit89[Client Libraries Explained](https://cloud.google.com/apis/docs/client-libraries-explained).90 91Although there are many benefits to moving to92[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),93the maintainers want to emphasize that `google-api-python-client` will continue94to be supported.95 96For Google Ads API, we recommend using [Google Ads API Client Library for Python](https://github.com/googleads/google-ads-python/).97 98For Google Firebase Admin API, we recommend using [Firebase Admin Python SDK](https://github.com/firebase/firebase-admin-python).99 100## Installation101 102Install this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. virtualenv is a tool to103create isolated Python environments. The basic problem it addresses is one of104dependencies and versions, and indirectly permissions.105 106With virtualenv, it's possible to install this library without needing system107install permissions, and without clashing with the installed system108dependencies.109 110### Mac/Linux111 112```bash113pip3 install virtualenv114virtualenv <your-env>115source <your-env>/bin/activate116<your-env>/bin/pip install google-api-python-client117```118 119### Windows120 121```batch122pip install virtualenv123virtualenv <your-env>124<your-env>\Scripts\activate125<your-env>\Scripts\pip.exe install google-api-python-client126```127 128## Supported Python Versions129 130Python 3.7, 3.8, 3.9, 3.10, 3.11 and 3.12 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.131 132## Unsupported Python Versions133 134Python < 3.7135 136## Third Party Libraries and Dependencies137 138The following libraries will be installed when you install the client library:139* [httplib2](https://github.com/httplib2/httplib2)140* [uritemplate](https://github.com/sigmavirus24/uritemplate)141 142For development you will also need the following libraries:143* [WebTest](https://pypi.org/project/WebTest/)144* [pyopenssl](https://pypi.python.org/pypi/pyOpenSSL)145 146## Contributing147 148Please see our [Contribution Guide](https://github.com/googleapis/google-api-python-client/blob/main/CONTRIBUTING.rst).149In particular, we love pull requests - but please make sure to sign150the contributor license agreement.151 