安裝

無論您是透過 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 [e-mail]: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