google api python client

谷歌API客户端

这是用于 Google 基于发现的 API 的 Google API Python 客户端库。要开始使用，请参阅 docs 文件夹。

该库被认为是完整的并且处于维护模式。这意味着我们将解决关键错误和安全问题，但不会添加任何新功能。

该库由 Google 官方支持。但是，此存储库的维护者建议在可能的情况下使用适用于 Python 的云客户端库进行新代码开发。欲了解更多信息，请访问客户端库解释。

2.0版本发布

与 1.x 相比， google-api-python-client 2.0 版本的可靠性得到了显着改进，因为发现文档现在缓存在库中而不是动态获取。强烈建议从 v1.x 升级到 v2.x。

仅支持 python 3.7 及更高版本。如果您无法升级 python，请继续使用 1.x 版本，因为我们将在 v1 中继续支持 python 2.7+。

当您调用discovery.build()时，将不再动态检索发现文档。发现文档将直接从客户端库检索。该库的新版本每周发布一次。由于缓存了发现文档，该包的大小比以前的版本至少大 50 MB。

请参阅迁移指南了解更多信息。

文档

请参阅 docs 文件夹以获取更详细的说明和其他文档。

其他 Google API 库

由于以下原因，此存储库的维护者建议在可能的情况下使用适用于 Python 的云客户端库进行新代码开发：

使用适用于 Python 的云客户端库：

• 每个 API 都有一个单独的客户端库，因此您可以选择下载哪些客户端库。而google-api-python-client是适用于所有 API 的单个客户端库。因此， google-api-python-client的总包大小超过 50MB。
• 由于每个客户端库都专注于特定的 API，因此对底层 API 的重大更改有更严格的控制。
• 这些云客户端库中有更多功能，因为每个库都专注于特定的 API，并且在某些情况下，这些库由专门研究该 API 的团队拥有。
• 开发人员将从智能感知中受益。

欲了解更多信息，请访问客户端库解释。

尽管迁移到 Python 云客户端库有很多好处，但维护者希望强调google-api-python-client将继续受到支持。

对于 Google Ads API，我们建议使用适用于 Python 的 Google Ads API 客户端库。

对于 Google Firebase Admin API，我们建议使用 Firebase Admin Python SDK。

安装

使用 pip 在 vi​​rtualenv 中安装此库。 virtualenv 是一个创建隔离的 Python 环境的工具。它解决的基本问题是依赖关系和版本以及间接权限之一。

使用 virtualenv，可以在不需要系统安装权限的情况下安装此库，并且不会与已安装的系统依赖项发生冲突。

苹果电脑/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

视窗

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

支持的 Python 版本

Python 3.7、3.8、3.9、3.10、3.11 和 3.12 得到完全支持和测试。该库可能适用于 3 的更高版本，但我们当前不针对这些版本运行测试。

不受支持的 Python 版本

Python < 3.7

第三方库和依赖项

安装客户端库时将安装以下库：

• httplib2
• 乌里模板

为了进行开发，您还需要以下库：

• 网络测试
• pyopenssl

贡献

请参阅我们的贡献指南。我们特别喜欢拉取请求 - 但请确保签署贡献者许可协议。