Python クライアント ライブラリは GitHub でホストされており、 パッケージは PyPI で入手できます。
要件
このライブラリには Python 3.9 以降が必要です。
前提条件
このガイドに進む前に、Google 広告アカウントの 10 桁の クライアントのお客様 ID が必要になります。
ランタイムと依存関係の互換性
Python クライアント ライブラリは、 Python Software Foundation が公開している サポート対象バージョン セクションの Python ランタイムとの互換性を維持しています。ただし、 ステータスが「機能」または「プレリリース」のバージョンは除きます。
Python ランタイムの新しいバージョンがリリースされ、Python Software Foundation によって正式にサポートされると、できるだけ早くそのバージョンを採用することを目指しています。
サポート終了(EOL)に達した Python ランタイムは、 EOL 日以降は python.org のサポート対象外バージョン セクションでサポートされません python.org。EOL 日以降は、EOL ランタイムと互換性のないライブラリのバージョンをリリースする可能性があるため、EOL ランタイムとの互換性は保証できません。
依存関係(特に、Python クライアント ライブラリで 必須としてリストされている Google が管理するパッケージ)については、Google が管理し、Google の OSS 破壊的変更ポリシーに準拠して「サポート対象」と見なされるパッケージとの互換性を維持します。
サポートされている Python ランタイムと依存関係の完全なリストについては、 依存関係のページをご覧ください。
インストール
インストール ガイドでは、ライブラリをインストールするさまざまな方法について説明しています。ライブラリをアプリケーションにインストールする最も簡単な方法(推奨)は、pip を使用することです。
$ python -m pip install google-ads
構成
ライブラリをインストールしたら、ライブラリの構成を設定する必要があります。ライブラリを構成する方法は複数あり、 構成ガイドで説明しています。
認証
構成方法を選択したら、認証構成を設定できます。手順については、 Python クライアント ライブラリの認証ガイドをご覧ください。 一般的な背景については、OAuth の概要をご覧ください。
API リクエストを発行する
認証構成を設定したら、API リクエストを発行する準備が整います。ライブラリが API リクエストを行うように正しく構成されていることをテストする簡単な方法については、 キャンペーンを取得するの例をご覧ください。
get_campaigns.py サンプルを実行するには、ローカルにインストールした googleads-python クライアント ライブラリのルート ディレクトリで次のコマンドを実行します。
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
参考情報
API リクエストを発行できるようになったら、クライアント ライブラリの次の用途に進みます。