安裝

無論是從 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. 確認您擁有 您的環境。使用 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