安装

无论您是从 PyPI 安装库还是从 GitHub 克隆库，都应使用有效的虚拟环境执行以下步骤。如需了解如何创建和激活虚拟环境，请参阅虚拟环境文档。

如需快速创建并激活虚拟环境，请执行以下操作：

python3 -m venv env
source env/bin/activate

从 PyPI 安装模块

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

python -m pip install google-ads

验证安装

验证模块是否已正确安装：

python -c "import google.ads.googleads"

从 GitHub 安装库

您可以从 GitHub 将该库的源代码克隆到本地机器上。克隆源代码有助于执行示例或开发库本身。请注意，运行其中一个身份验证示例是配置库以供使用的必要步骤。

1. 确保您的环境中存在受支持的 Python 版本（Python 3.9 到 3.14；建议使用 Python 3.11 或更高版本）。最简单的方法是使用 pyenv：

   pyenv install 3.13
   pyenv local 3.13

2. 从 GitHub 克隆客户端库：

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

3. 进入代码库并以可修改模式安装：

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

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

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

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

   2. 安装库的特定于测试的依赖项：

      python -m pip install -e ".[tests]"

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

      nox

   4. 可选：您还可以使用 Docker 运行单元测试。首先，确保您已安装 Docker。然后，从 google-ads-python 目录运行以下命令：

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