Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

インストール

PyPI からライブラリをインストールする場合でも、GitHub からクローンを作成する場合でも、アクティブな仮想環境を使用して次の手順を行います。仮想環境を作成して有効にする方法については、仮想環境のドキュメントをご覧ください。

仮想環境をすばやく作成して有効にするには:

python3 -m venv env
source env/bin/activate

PyPI からモジュールをインストールする

このライブラリは PyPI で配布されており、pip を使用して次のコマンドでインストールできます。

python -m pip install google-ads

モジュールが正しくインストールされていることを確認します。

python -c "import google.ads.googleads"

ライブラリのソースコードは、GitHub からローカルマシンにクローンできます。ソースコードのクローンを作成すると、サンプルの実行やライブラリ自体の開発に役立ちます。参考までに、認証の例のいずれかを実行することは、ライブラリを使用するために構成するうえで必要なステップです。

サポートされている Python バージョン（Python 3.9 ～ 3.14、Python 3.11 以降を推奨）が環境に存在することを確認します。最も簡単な方法は、pyenv を使用することです。
```
pyenv install 3.13
pyenv local 3.13
```
GitHub からクライアントライブラリのクローンを作成します。
```
git clone https://github.com/googleads/google-ads-python.git
```
リポジトリを入力し、編集可能モードでインストールします。
```
cd google-ads-python
python -m pip install -e .
```
ライブラリを開発する場合は、変更を加える前後に単体テストを実行します。
1. pyenv を使用して、サポートされているすべてのバージョンの Python 言語が環境で使用可能であることを確認します。
```
pyenv local 3.9 3.10 3.11 3.12 3.13 3.14
```
2. ライブラリのテスト固有の依存関係をインストールします。
```
python -m pip install -e ".[tests]"
```
3. 単体テストを実行して、ライブラリが正常に機能していることを確認します。
```
nox
```
4. 省略可: Docker を使用して単体テストを実行することもできます。まず、Docker がインストールされていることを確認します。次に、google-ads-python ディレクトリから次のコマンドを実行します。
```
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
```