Python クライアント ライブラリは GitHub でホストされ、パッケージは PyPI で入手できます。
要件
このライブラリは、Python 3.9 から 3.14 をサポートしています（>=3.9, <3.15。Python 3.14 のサポートは v28.2.0 で追加されました）。Python 3.9 と 3.10 では、google-ads v32.0.0 以降でインポート時に非推奨の警告が表示されるため、Python 3.11 以降を使用することをおすすめします。
前提条件
このガイドに進む前に、Google 広告アカウントの 10 桁のクライアント顧客 ID が必要です。
ランタイムと依存関係の互換性
Python クライアント ライブラリは、Python Software Foundation が公開しているサポート対象バージョン セクションの Python ランタイムとの互換性を維持しています。ただし、ステータスが「feature」または「prerelease」のバージョンは除きます。
Google Ads API チームは、Python ランタイムの新しいバージョンがリリースされ、Python Software Foundation によって公式にサポートされると、すぐに新しいバージョンを採用することを目指しています。
サポート終了（EOL）に達した Python ランタイムは、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 サンプルを実行するには、まず google-ads-python リポジトリのクローンを作成します。次に、クローンされたリポジトリのルート ディレクトリから次のコマンドを実行します。
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
参考情報
API リクエストを行えるようになったら、クライアント ライブラリの次の使用方法に進みます。