google-api-python-client


Namegoogle-api-python-client JSON
Version 2.63.0 PyPI version JSON
download
home_pagehttps://github.com/googleapis/google-api-python-client/
SummaryGoogle API Client Library for Python
upload_time2022-09-27 15:58:55
maintainer
docs_urlNone
authorGoogle LLC
requires_python>=3.7
licenseApache 2.0
keywords google api client
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # Google API Client

[![PyPI version](https://badge.fury.io/py/google-api-python-client.svg)](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/main/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` 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.7 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](https://github.com/googleapis/google-api-python-client/tree/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](https://github.com/googleapis/google-api-python-client/blob/main/UPGRADING.md)
for more information.

## Documentation

See the [docs folder](https://github.com/googleapis/google-api-python-client/blob/main/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

```
pip3 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.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.7

## 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/main/CONTRIBUTING.rst).
In particular, we love pull requests - but please make sure to sign
the contributor license agreement.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/googleapis/google-api-python-client/",
    "name": "google-api-python-client",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "google api client",
    "author": "Google LLC",
    "author_email": "googleapis-packages@google.com",
    "download_url": "https://files.pythonhosted.org/packages/0d/a5/ecbcb0e6340c960f6077a92c806603caaeefc2b827a53a3c1d994b126e76/google-api-python-client-2.63.0.tar.gz",
    "platform": null,
    "description": "# Google API Client\n\n[![PyPI version](https://badge.fury.io/py/google-api-python-client.svg)](https://badge.fury.io/py/google-api-python-client)\n\nThis is the [Google API Python client library](https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries)\nfor Google's discovery based APIs. To get started, please see the\n[docs folder](https://github.com/googleapis/google-api-python-client/blob/main/docs/README.md).\n\nThis library is considered complete and is in maintenance mode. This means\nthat we will address critical bugs and security issues but will not add any\nnew features.\n\nThis library is officially supported by Google.  However, the maintainers of\nthis repository recommend using [Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),\nwhere possible, for new code development. For more information, please visit\n[Client Libraries Explained](https://cloud.google.com/apis/docs/client-libraries-explained).\n\n## Version 2.0 Release\nThe 2.0 release of `google-api-python-client` includes a substantial reliability \nimprovement, compared with 1.x, as discovery documents are now cached in the library \nrather than fetched dynamically. It is highly recommended to upgrade from v1.x to v2.x.\n\nOnly python 3.7 and newer is supported. If you are not able to upgrade python, then\nplease continue to use version 1.x as we will continue supporting python 2.7+ in\n[v1](https://github.com/googleapis/google-api-python-client/tree/v1).\n\nDiscovery documents will no longer be retrieved dynamically when\nyou call `discovery.build()`. The discovery documents will instead be retrieved\nfrom the client library directly. New versions of this library are released weekly.\nAs a result of caching the discovery documents, the size of this package is at least \n50 MB larger compared to the previous version. \n\nPlease see the [Migration Guide](https://github.com/googleapis/google-api-python-client/blob/main/UPGRADING.md)\nfor more information.\n\n## Documentation\n\nSee the [docs folder](https://github.com/googleapis/google-api-python-client/blob/main/docs/README.md) for more detailed instructions and additional documentation.\n\n## Other Google API libraries\n\nThe maintainers of this repository recommend using\n[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),\nwhere possible, for new code development due to the following reasons:\n\nWith [Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python):\n- There is a separate client library for each API, so you can choose\nwhich client libraries to download. Whereas, `google-api-python-client` is a\nsingle client library for all APIs. As a result, the total package size for\n`google-api-python-client` exceeds 50MB.\n- There are stricter controls for breaking changes to the underlying APIs\nas each client library is focused on a specific API.\n- There are more features in these Cloud Client Libraries as each library is\nfocused on a specific API, and in some cases, the libraries are owned by team\nwho specialized in that API.\n- Developers will benefit from intellisense.\n\nFor more information, please visit\n[Client Libraries Explained](https://cloud.google.com/apis/docs/client-libraries-explained).\n\nAlthough there are many benefits to moving to\n[Cloud Client Libraries for Python](https://github.com/googleapis/google-cloud-python),\nthe maintainers want to emphasize that `google-api-python-client` will continue\nto be supported.\n\nFor Google Ads API, we recommend using [Google Ads API Client Library for Python](https://github.com/googleads/google-ads-python/).\n\nFor Google Firebase Admin API, we recommend using [Firebase Admin Python SDK](https://github.com/firebase/firebase-admin-python).\n\n## Installation\n\nInstall this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. virtualenv is a tool to\ncreate isolated Python environments. The basic problem it addresses is one of\ndependencies and versions, and indirectly permissions.\n\nWith virtualenv, it's possible to install this library without needing system\ninstall permissions, and without clashing with the installed system\ndependencies.\n\n### Mac/Linux\n\n```\npip3 install virtualenv\nvirtualenv <your-env>\nsource <your-env>/bin/activate\n<your-env>/bin/pip install google-api-python-client\n```\n\n### Windows\n\n```\npip install virtualenv\nvirtualenv <your-env>\n<your-env>\\Scripts\\activate\n<your-env>\\Scripts\\pip.exe install google-api-python-client\n```\n\n## Supported Python Versions\n\nPython 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.\n\n## Unsupported Python Versions\n\nPython < 3.7\n\n## Third Party Libraries and Dependencies\n\nThe following libraries will be installed when you install the client library:\n* [httplib2](https://github.com/httplib2/httplib2)\n* [uritemplate](https://github.com/sigmavirus24/uritemplate)\n\nFor development you will also need the following libraries:\n* [WebTest](http://webtest.pythonpaste.org/en/latest/index.html)\n* [pyopenssl](https://pypi.python.org/pypi/pyOpenSSL)\n\n## Contributing\n\nPlease see our [Contribution Guide](https://github.com/googleapis/google-api-python-client/blob/main/CONTRIBUTING.rst).\nIn particular, we love pull requests - but please make sure to sign\nthe contributor license agreement.\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Google API Client Library for Python",
    "version": "2.63.0",
    "split_keywords": [
        "google",
        "api",
        "client"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "24ebac0967ef2d20f2f7cb71c2305fd3",
                "sha256": "ccb198e11a60324693f8eaff4bee09502e5f35a6c829a7a1ef41a654c8fc2561"
            },
            "downloads": -1,
            "filename": "google_api_python_client-2.63.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "24ebac0967ef2d20f2f7cb71c2305fd3",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.7",
            "size": 9312704,
            "upload_time": "2022-09-27T15:58:52",
            "upload_time_iso_8601": "2022-09-27T15:58:52.542154Z",
            "url": "https://files.pythonhosted.org/packages/9c/38/d05a079974c2130a72263e98bf290a7a6377e70dffe76c9051d6e4dcd079/google_api_python_client-2.63.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "bcf3864deb7f639269018f2caadaa559",
                "sha256": "5cc828499a2cfec5845e095d32f68265c344eb32969f07a8e3774564153178bd"
            },
            "downloads": -1,
            "filename": "google-api-python-client-2.63.0.tar.gz",
            "has_sig": false,
            "md5_digest": "bcf3864deb7f639269018f2caadaa559",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 8883062,
            "upload_time": "2022-09-27T15:58:55",
            "upload_time_iso_8601": "2022-09-27T15:58:55.238073Z",
            "url": "https://files.pythonhosted.org/packages/0d/a5/ecbcb0e6340c960f6077a92c806603caaeefc2b827a53a3c1d994b126e76/google-api-python-client-2.63.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-09-27 15:58:55",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "googleapis",
    "github_project": "google-api-python-client",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "google-api-python-client"
}
        
Elapsed time: 0.56919s