Installation

Unabhängig davon, ob Sie die Bibliothek von PyPI installieren oder von GitHub klonen, führen Sie die folgenden Schritte in einer aktiven virtuellen Umgebung aus. Informationen zum Erstellen und Aktivieren einer virtuellen Umgebung finden Sie in der Dokumentation Virtual Environment.

So erstellen und aktivieren Sie schnell eine virtuelle Umgebung:

python3 -m venv env
source env/bin/activate

Modul über PyPI installieren

Die Bibliothek wird auf PyPI verteilt und kann mit dem folgenden Befehl über pip installiert werden:

python -m pip install google-ads

Installation prüfen

Prüfen Sie, ob das Modul korrekt installiert wurde:

python -c "import google.ads.googleads"

Bibliothek von GitHub installieren

Der Quellcode für die Bibliothek kann von GitHub auf Ihren lokalen Computer geklont werden. Das Klonen des Quellcodes ist nützlich, um die Beispiele auszuführen oder die Bibliothek selbst zu entwickeln. Zur Erinnerung: Das Ausführen eines der Authentifizierungsbeispiele ist ein erforderlicher Schritt bei der Konfiguration der Bibliothek.

  1. Prüfen Sie, ob in Ihrer Umgebung eine unterstützte Python-Version (Python 3.9 bis 3.14; Python 3.11 oder höher empfohlen) vorhanden ist. Am einfachsten ist es, pyenv zu verwenden:

    pyenv install 3.13
pyenv local 3.13

  2. Klonen Sie die Clientbibliothek aus GitHub:

    git clone https://github.com/googleads/google-ads-python.git

  3. Rufen Sie das Repository auf und installieren Sie es im bearbeitbaren Modus:

    cd google-ads-python
python -m pip install -e .

  4. Wenn Sie die Bibliothek entwickeln möchten, führen Sie die Unittests vor und nach jeder Änderung aus:

    1. Prüfen Sie, ob alle unterstützten Versionen der Python-Sprache in Ihrer Umgebung verfügbar sind, indem Sie pyenv verwenden:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Installieren Sie die testspezifischen Abhängigkeiten der Bibliothek:

      python -m pip install -e ".[tests]"

    3. Führen Sie die Einheitentests aus, um sicherzustellen, dass die Bibliothek ordnungsgemäß funktioniert:

      nox

    4. Optional: Sie können die Unittests auch mit Docker ausführen. Prüfen Sie zuerst, ob Docker installiert ist. Führen Sie dann im Verzeichnis google-ads-python die folgenden Befehle aus:

      docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox