140 lines
5.8 KiB
Text
140 lines
5.8 KiB
Text
|
Metadata-Version: 2.1
|
||
|
|
Name: google-api-python-client
|
||
|
|
Version: 2.2.0
|
||
|
|
Summary: Google API Client Library for Python
|
||
|
|
Home-page: https://github.com/googleapis/google-api-python-client/
|
||
|
|
Author: Google LLC
|
||
|
|
Author-email: googleapis-packages@google.com
|
||
|
|
License: Apache 2.0
|
||
|
|
Keywords: google api client
|
||
|
|
Platform: UNKNOWN
|
||
|
|
Classifier: Programming Language :: Python :: 3
|
||
|
|
Classifier: Programming Language :: Python :: 3.6
|
||
|
|
Classifier: Programming Language :: Python :: 3.7
|
||
|
|
Classifier: Programming Language :: Python :: 3.8
|
||
|
|
Classifier: Programming Language :: Python :: 3.9
|
||
|
|
Classifier: Development Status :: 5 - Production/Stable
|
||
|
|
Classifier: Intended Audience :: Developers
|
||
|
|
Classifier: License :: OSI Approved :: Apache Software License
|
||
|
|
Classifier: Operating System :: OS Independent
|
||
|
|
Classifier: Topic :: Internet :: WWW/HTTP
|
||
|
|
Requires-Python: >=3.6
|
||
|
|
Description-Content-Type: text/markdown
|
||
|
|
Requires-Dist: httplib2 (<1dev,>=0.15.0)
|
||
|
|
Requires-Dist: google-auth (<2dev,>=1.16.0)
|
||
|
|
Requires-Dist: google-auth-httplib2 (>=0.1.0)
|
||
|
|
Requires-Dist: google-api-core (<2dev,>=1.21.0)
|
||
|
|
Requires-Dist: six (<2dev,>=1.13.0)
|
||
|
|
Requires-Dist: uritemplate (<4dev,>=3.0.0)
|
||
|
|
|
||
|
|
# Google API Client
|
||
|
|
|
||
|
|
[](https://badge.fury.io/py/google-api-python-client)
|
||
|
|
|
||
|
|
This is the [Google API Python client library](https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries)
|
||
|
|
for Google's discovery based APIs. To get started, please see the
|
||
|
|
[docs folder](https://github.com/googleapis/google-api-python-client/blob/master/docs/README.md).
|
||
|
|
|
||
|
|
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](https://github.com/googleapis/google-cloud-python),
|
||
|
|
where possible, for new code development. For more information, please visit
|
||
|
|
[Client Libraries Explained](https://cloud.google.com/apis/docs/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](https://github.com/googleapis/google-api-python-client/blob/master/UPGRADING.md) 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](https://github.com/googleapis/google-api-python-client/blob/master/docs/README.md) for more detailed instructions and additional documentation.
|
||
|
|
|
||
|
|
## Other Google API libraries
|
||
|
|
|
||
|
|
The maintainers of this repository recommend using
|
||
|
|
[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),
|
||
|
|
where possible, for new code development due to the following reasons:
|
||
|
|
|
||
|
|
With [Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-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](https://cloud.google.com/apis/docs/client-libraries-explained).
|
||
|
|
|
||
|
|
Although there are many benefits to moving to
|
||
|
|
[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-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](https://github.com/googleads/google-ads-python/).
|
||
|
|
|
||
|
|
For Google Firebase Admin API, we recommend using [Firebase Admin Python SDK](https://github.com/firebase/firebase-admin-python).
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
Install this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) 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:
|
||
|
|
* [httplib2](https://github.com/httplib2/httplib2)
|
||
|
|
* [uritemplate](https://github.com/sigmavirus24/uritemplate)
|
||
|
|
|
||
|
|
For development you will also need the following libraries:
|
||
|
|
* [WebTest](http://webtest.pythonpaste.org/en/latest/index.html)
|
||
|
|
* [pyopenssl](https://pypi.python.org/pypi/pyOpenSSL)
|
||
|
|
|
||
|
|
## Contributing
|
||
|
|
|
||
|
|
Please see our [Contribution Guide](https://github.com/googleapis/google-api-python-client/blob/master/CONTRIBUTING.rst).
|
||
|
|
In particular, we love pull requests - but please make sure to sign
|
||
|
|
the contributor license agreement.
|
||
|
|
|
||
|
|
|