Python 客户端库托管在 GitHub 上, 软件包可在 PyPI 上获取。
要求
该库需要 Python 3.9 或更高版本。
前提条件
在继续阅读本指南之前,您需要具备 开发者令牌(用于 Google Ads API)以及 Google Ads 账号的 10 位数 客户客户 ID。
运行时和依赖项兼容性
Python 客户端库与 Python Software Foundation在 支持的版本 部分中发布的 Python 运行时保持兼容,但状态为“功能”或“预发布”的版本除外。
我们的目标是尽快采用 Python Software Foundation 发布并正式支持的新版 Python 运行时。
对于已达到生命周期终止 (EOL) 的 Python 运行时,在 EOL 日期之后,我们将不再提供支持。有关详细信息,请参阅 python.org 的 python.org部分。我们无法保证与 EOL 运行时兼容,因为我们可能会在 EOL 日期之后的任何时间发布与这些运行时不兼容的库版本。
对于依赖项(具体而言,是指 Python 客户端库列为 必需 的任何 Google 维护的软件包),我们将与 Google 维护的软件包保持兼容,并且根据 Google 的 OSS 破坏性更改政策,这些软件包被视为“受支持”。
如需查看受支持的 Python 运行时和依赖项的完整列表,请参阅 依赖项页面。
安装
我们的安装指南介绍了安装该库的所有不同方法
。将该库安装到应用中的最简单(也是推荐)的方法是使用 pip:
$ python -m pip install google-ads
配置
安装该库后,您需要为其设置配置。您可以通过多种方式配置该库,我们的 配置指南对此进行了介绍。
身份验证
选择配置方法后,您就可以设置身份验证配置了。如需获取分步说明,请参阅我们的 Python 客户端库身份验证指南指南, 如需了解更多一般背景信息,请参阅我们的 OAuth 概览。
发出 API 请求
设置身份验证配置后,您就可以发出 API 请求了。如需快速测试该库是否已正确配置为发出 API 请求,请参阅 获取广告系列示例。
如需运行 get_campaigns.py 示例,请在本地安装的 googleads-python 客户端库的根目录下运行以下命令:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
其他资源
能够发出 API 请求后,请继续了解客户端库的以下用途: