Die Python-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf PyPI verfügbar.
Voraussetzungen
Die Bibliothek unterstützt Python 3.9 bis 3.14 (>=3.9, <3.15; die Unterstützung für Python 3.14 wurde in v28.2.0 hinzugefügt). Da Python 3.9 und 3.10 beim Import in google-ads v32.0.0 und höher eine Einstellungswarnung ausgeben, wird die Verwendung von Python 3.11 oder höher empfohlen.
Vorbereitung
Bevor Sie mit diesem Leitfaden fortfahren, benötigen Sie die zehnstellige Kundennummer Ihres Google Ads-Kontos.
Laufzeit- und Abhängigkeitskompatibilität
Die Python-Clientbibliothek ist mit den Python-Laufzeiten im Abschnitt Unterstützte Versionen kompatibel, die von der Python Software Foundation veröffentlicht wurden, mit Ausnahme von Versionen mit dem Status „Feature“ oder „Vorabversion“.
Das Google Ads API-Team ist bestrebt, neue Versionen der Python-Laufzeit zu übernehmen, sobald sie veröffentlicht und offiziell von der Python Software Foundation unterstützt werden.
Python-Laufzeiten, die das Ende des Produktzyklus (End of Life, EOL) erreicht haben, werden nach dem EOL-Datum im Abschnitt Nicht unterstützte Versionen auf python.org nicht mehr unterstützt. Die Kompatibilität mit EOL-Laufzeiten kann nicht garantiert werden, da Releases der Bibliothek nach einem EOL-Datum die Kompatibilität beeinträchtigen können.
Für Abhängigkeiten (insbesondere alle von Google verwalteten Pakete, die von der Python-Clientbibliothek als erforderlich aufgeführt sind) wird die Kompatibilität mit Paketen aufrechterhalten, die von Google verwaltet werden und gemäß der Richtlinie für funktionsgefährdende Änderungen in OSS 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 der Installationsanleitung 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
Nach der Installation der Bibliothek müssen Sie eine Konfiguration dafür einrichten. Es gibt mehrere Möglichkeiten, die Bibliothek zu konfigurieren. Diese werden im Konfigurationsleitfaden beschrieben.
Authentifizierung
Nachdem Sie einen Konfigurationsansatz ausgewählt haben, richten Sie Ihre Authentifizierungskonfiguration ein. Eine detaillierte Anleitung finden Sie im Authentifizierungsleitfaden für die Python-Clientbibliothek. Weitere allgemeine Informationen finden Sie in der OAuth-Übersicht.
API-Anfrage stellen
Nachdem Sie die Authentifizierungskonfiguration eingerichtet haben, können Sie eine API-Anfrage stellen. Im Beispiel Kampagnen abrufen finden Sie eine schnelle Möglichkeit, um zu testen, ob die Bibliothek richtig für API-Anfragen konfiguriert ist.
Wenn Sie das get_campaigns.py-Beispiel ausführen möchten, klonen Sie zuerst das google-ads-python-Repository. Führen Sie dann im Stammverzeichnis des geklonten Repositorys den folgenden Befehl aus:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Zusätzliche Ressourcen
Nachdem Sie eine API-Anfrage stellen können, fahren Sie mit den folgenden Verwendungen der Clientbibliothek fort: