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 Software Foundation が新しいバージョンの Python ランタイムをリリースし、公式にサポートすると、すぐにそのバージョンを採用することを目指しています。
サポート終了（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 リクエストを行えるようになったら、クライアント ライブラリの次の使用方法に進みます。