Installation

Unabhängig davon, ob Sie die Bibliothek über 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 zur virtuellen Umgebung.

Modul über PyPI installieren

Die Bibliothek wird über PyPI vertrieben 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. Zur Information: Das Ausführen eines der Authentifizierungsbeispiele ist ein erforderlicher Schritt bei der Konfiguration der Bibliothek für die Verwendung.

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 weiterentwickeln möchten, führen Sie die Unit-Tests vor und nach jeder Änderung aus:

   1. Prüfen Sie, ob alle unterstützten Versionen der Python-Sprache 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 Unit-Tests aus, um sicherzustellen, dass die Bibliothek ordnungsgemäß funktioniert:

      nox

   4. Optional: Die Unit-Tests können auch mit Docker ausgeführt werden. Zuerst muss Docker installiert sein. 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