安裝

無論您是從 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