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 diesem Leitfaden fortfahren, benötigen Sie ein Entwicklertoken für die Google Ads API und die 10-stellige Kunden-ID Ihres Google Ads-Kontos.
Laufzeit- und Abhängigkeitskompatibilität
Die Python-Clientbibliothek ist mit den Python-Laufzeiten in dem Abschnitt Unterstützte Versionen kompatibel, der von der Python Software Foundationveröffentlicht wurde. Ausgenommen sind Versionen mit dem Status „Feature“ oder „Vorabversion“.
Wir bemühen uns, neue Versionen der Python-Laufzeit so bald wie möglich einzuführen, nachdem sie von der Python Software Foundation veröffentlicht und offiziell unterstützt wurden.
Python-Laufzeiten, die das End-of-Life-Datum (EOL) erreicht haben, werden nach dem EOL-Datum im Abschnitt Nicht unterstützte Versionen von python.org nicht mehr unterstützt. Wir können die Kompatibilität mit EOL-Laufzeiten nicht 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 alle von Google verwalteten Pakete, die als für die Python-Clientbibliothek erforderlich aufgeführt sind ) sorgen wir für Kompatibilität mit Paketen, die von Google verwaltet werden und gemäß der Google-Richtlinie zu Breaking Changes in Open-Source-Software 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 unserem Installationsleitfaden werden alle
Möglichkeiten zur Installation der Bibliothek beschrieben. Die einfachste (und empfohlene) Methode, die Bibliothek in Ihrer Anwendung zu installieren, 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 einen Konfigurationsansatz ausgewählt haben, können Sie die Authentifizierungskonfiguration einrichten. Eine detaillierte Anleitung finden Sie in unserem Leitfaden zur Authentifizierung der Python-Clientbibliothek. Weitere 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 Kampagnen abrufen erfahren Sie, wie Sie schnell testen können, ob die Bibliothek richtig konfiguriert ist, um API Anfragen zu stellen.
Führen Sie den folgenden Befehl im Stammverzeichnis Ihrer lokal installierten googleads-python-Clientbibliothek aus, um das Beispiel get_campaigns.py auszuführen:
$ 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 diesen Verwendungszwecken der Clientbibliothek fort: