Installation

Unabhängig davon, ob Sie die Bibliothek von PyPI installieren oder von 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 bereitgestellt 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 sinnvoll, den Quellcode zu klonen, um die Beispiele einfach 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 python3.8 oder höher in Ihrer Umgebung vorhanden ist. Am einfachsten ist es, pyenv zu verwenden:

    pyenv local 3.8
  2. Klonen Sie die Clientbibliothek aus GitHub:

    git clone git@github.com:googleads/google-ads-python.git
  3. Rufen Sie das Repository auf und installieren Sie es:

    cd google-ads-python
    python -m pip install .
  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. pyenv verwenden::

      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 Komponententests 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 installieren. Führen Sie dann im Verzeichnis google-ads-python Folgendes aus:

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