Installation

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

Modul aus PyPI installieren

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

python -m pip install google-ads

Bibliothek von GitHub installieren

Der Quellcode für die Bibliothek kann von GitHub auf Ihren lokalen Computer geklont werden. Es ist nützlich, den Quellcode zu klonen, um die Beispiele einfach auszuführen oder die Bibliothek selbst zu entwickeln. Das Ausführen eines der Authentifizierungsbeispiele ist ein erforderlicher Schritt, um die Bibliothek für die Verwendung zu konfigurieren.

  1. Achten Sie darauf, dass python3.8 oder höher in Ihrer Umgebung vorhanden ist. Die einfachste Möglichkeit ist die Verwendung von pyenv:

    pyenv local 3.8

  2. Klonen Sie die Clientbibliothek aus GitHub:

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

  3. Geben Sie das Repository ein und installieren Sie es:

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

  4. Wenn Sie die Bibliothek entwickeln möchten, führen Sie die Einheitentests vor und nach den Änderungen aus:

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

      pyenv local 3.8 3.9 3.10 3.11 3.12

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

      python -m pip install .[tests]

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

      nox

    4. Optional: Die Einheitentests können auch mit Docker ausgeführt werden. Zuerst müssen Sie Docker installiert haben. Führen Sie dann im Verzeichnis google-ads-python folgenden Befehl aus:

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