Die Python-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf PyPI verfügbar.
Anforderungen
Für die Bibliothek ist Python 3.9 oder höher erforderlich.
Vorbereitung
Bevor Sie mit diesem Leitfaden fortfahren, benötigen Sie die 10-stellige Kundennummer Ihres Google Ads-Kontos.
Kompatibilität von Laufzeit und Abhängigkeiten
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 „Prerelease“.
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 auf 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 bei von Google verwalteten Paketen, die von der Python-Clientbibliothek als erforderlich aufgeführt sind ) sorgen wir für Kompatibilität mit Paketen, die von Google verwaltet werden und gemäß der Google-Richtlinie zu OSS-Änderungen, die Inkompatibilitäten verursachen, 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: