このページは Cloud Translation API によって翻訳されました。

インストール

PyPI からライブラリをインストールする場合でも、GitHub からクローンを作成する場合でも、次の手順は、仮想マシン（VM）インスタンス VM にできます。仮想マシンを作成して有効にする方法については、仮想環境のドキュメントをご覧ください。

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

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

python -m pip install google-ads

ライブラリのソースコードは GitHub からクローンを作成できます。インストールします。ソースコードのクローンを作成すると、ソースコードのサンプルの実行やライブラリ自体の開発を行えます。参考までに、認証例の 1 つは、ライブラリを構成する際の使用できます。

python3.8 以降が環境に存在することを確認します。最も簡単な方法は、pyenv を使用することです。
```
pyenv local 3.8
```
GitHub からクライアントライブラリのクローンを作成します。
```
git clone git@github.com:googleads/google-ads-python.git
```
リポジトリを入力してインストールします。
```
cd google-ads-python
python -m pip install .
```
ライブラリを開発する場合は、前後に単体テストを実施してください。次のように変更します。
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
```