Installation

Unabhängig davon, ob Sie die Bibliothek aus PyPI installieren oder aus GitHub klonen, führen Sie die folgenden Schritte mit einem aktiven virtuellen zu verbessern. Weitere Informationen zum Erstellen und Aktivieren einer finden Sie in der Dokumentation zur virtuellen Umgebung.

Modul aus PyPI installieren

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

python -m pip install google-ads

Bibliothek von GitHub installieren

Der Quellcode für die Bibliothek kann von GitHub geklont werden. auf Ihren lokalen Computer übertragen. Es ist hilfreich, den Quellcode zu klonen, um die Beispiele auszuführen oder die Bibliothek selbst zu entwickeln. Zu Ihrer Information: Eines der Authentifizierungsbeispiele ist ein erforderlicher Schritt zur Konfiguration der Bibliothek zu verwenden.

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

    pyenv local 3.8
    
  2. Klonen Sie die Clientbibliothek von 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 davor und danach aus Änderungen vornehmen:

    1. Achten Sie darauf, dass alle unterstützten Versionen der Python-Sprache verfügbar sind in für Ihre Umgebung. 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. Zunächst müssen Sie Docker installiert haben. Danach dem Verzeichnis google-ads-python, führen Sie folgenden Befehl aus:

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