安裝

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