Die Python-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf PyPI verfügbar.
Voraussetzungen
Für die Bibliothek ist Python 3.9 oder höher erforderlich.
Vorbereitung
Bevor Sie mit dieser Anleitung fortfahren, benötigen Sie ein Entwicklertoken für die Google Ads API und die 10-stellige Kunden-ID für Ihr Google Ads-Konto.
Laufzeit- und Abhängigkeitskompatibilität
Die Python-Clientbibliothek ist mit den Python-Laufzeiten im Abschnitt Unterstützte Versionen kompatibel, der von der Python Software Foundation veröffentlicht wird. Ausgenommen sind Versionen mit dem Status „feature“ oder „prerelease“.
Wir möchten neue Versionen der Python-Laufzeitumgebung so schnell wie möglich einführen, sobald sie von der Python Software Foundation veröffentlicht und offiziell unterstützt werden.
Python-Laufzeiten, die das End of Life (EOL) erreicht haben, werden nach dem EOL-Datum im Abschnitt Unsupported Versions auf python.org nicht mehr unterstützt. Wir können keine Kompatibilität mit EOL-Runtimes garantieren, da wir jederzeit nach dem EOL-Datum eine Version der Bibliothek veröffentlichen können, die nicht mit ihnen kompatibel ist.
Bei Abhängigkeiten, insbesondere bei allen von Google verwalteten Paketen, die von der Python-Clientbibliothek als erforderlich aufgeführt werden, sorgen wir für Kompatibilität mit Paketen, die von Google verwaltet werden und gemäß der OSS Breaking Change Policy von Google als „unterstützt“ gelten.
Eine vollständige Liste der unterstützten Python-Laufzeiten und ‑Abhängigkeiten finden Sie auf der Seite Abhängigkeiten.
Installation
In unserer Installationsanleitung finden Sie alle Möglichkeiten zur Installation der Bibliothek. Die einfachste (und empfohlene) Methode zum Installieren der Bibliothek in Ihrer Anwendung ist die Verwendung von pip:
$ python -m pip install google-ads
Konfiguration
Nachdem Sie die Bibliothek installiert haben, müssen Sie eine Konfiguration dafür einrichten. Es gibt mehrere Möglichkeiten, die Bibliothek zu konfigurieren. Diese werden in unserem Konfigurationsleitfaden beschrieben.
Authentifizierung
Nachdem Sie sich für einen Konfigurationsansatz entschieden haben, können Sie die Authentifizierungskonfiguration einrichten. Eine detaillierte Anleitung finden Sie in unserem Authentifizierungsleitfaden für die Python-Clientbibliothek. Allgemeine Informationen finden Sie in unserer OAuth-Übersicht.
API-Anfrage stellen
Nachdem Sie die Authentifizierungskonfiguration eingerichtet haben, können Sie eine API-Anfrage stellen. Im Beispiel für „get campaigns“ finden Sie eine schnelle Möglichkeit, um zu testen, ob die Bibliothek richtig konfiguriert ist, um API-Anfragen zu stellen.
Führen Sie zum Ausführen des get_campaigns.py-Beispiels im Stammverzeichnis Ihrer lokal installierten googleads-python-Clientbibliothek den folgenden Befehl aus:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Zusätzliche Ressourcen
Nachdem Sie eine API-Anfrage stellen können, fahren Sie mit den folgenden Anwendungsfällen der Clientbibliothek fort: