安裝

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