安装

无论您是从 PyPI 安装库，还是从 GitHub 克隆库，我们 建议您使用活跃虚拟虚拟机执行以下步骤 环境有关如何创建和激活 请参阅虚拟环境文档。

通过 PyPI 安装模块

该库在 PyPI 上分发，可以 使用pip进行安装 以下命令：

python -m pip install google-ads

从 GitHub 安装该库

该库的源代码可以从 GitHub 克隆 复制到本地机器上克隆源代码很实用 执行示例或开发库本身。运行 其中一个身份验证示例是配置库的必要步骤 使用。

  1. 确保您的环境中存在 python3.8 或更高版本。 最简单的方法是使用 pyenv：

    pyenv local 3.8

  2. 从 GitHub 克隆客户端库：

    git clone git@github.com:googleads/google-ads-python.git

  3. 输入代码库并进行安装：

    cd google-ads-python
python -m pip install .

  4. 如果您打算开发该库，请在开发库前后分别运行单元测试 进行更改：

    1. 确保 Python 语言的所有受支持版本 您的环境使用 pyenv：

      pyenv local 3.8 3.9 3.10 3.11 3.12

    2. 安装库的测试专用依赖项：

      python -m pip install .[tests]

    3. 运行单元测试，确保库正常运行：

      nox

    4. 可选：您也可以使用 Docker 运行单元测试。首先，您必须 安装了 Docker。然后，从 google-ads-python 目录中，请运行以下命令：

      docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox