Google 広告のサービスに関するご意見やご提案は、Google 広告と測定のコミュニティサーバーの公式 Google 広告 Discord チャンネルにご参加ください。

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

インストール

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

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

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

python -m pip install google-ads

ライブラリのソースコードは、GitHub からローカルマシンにクローンできます。ソースコードを複製すると、例を簡単に実行したり、ライブラリ自体を開発したりするのに便利です。参考までに、認証の例のいずれかを実行することは、ライブラリを使用するように構成するうえで必要な手順です。

環境に 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
```