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 Warnung zur Einstellung ausgeben, wird die Verwendung von Python 3.11 oder höher empfohlen.
Vorbereitung
Bevor Sie mit dieser Anleitung 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, der von der Python Software Foundation veröffentlicht wird. Ausgenommen sind Versionen mit dem Status „feature“ oder „prerelease“.
Das Google Ads API-Team ist bestrebt, neue Versionen der Python-Laufzeit so bald wie möglich nach ihrer Veröffentlichung und offiziellen Unterstützung durch die Python Software Foundation zu übernehmen.
Python-Laufzeiten, die ihr End of Life (EOL) erreicht haben, werden nach dem EOL-Datum im Abschnitt Unsupported Versions auf python.org nicht mehr unterstützt. Die Kompatibilität mit EOL-Runtimes kann nicht garantiert werden, da Releases der Bibliothek nach einem EOL-Datum die Kompatibilität beeinträchtigen können.
Bei Abhängigkeiten (insbesondere bei allen von Google verwalteten Paketen, die von der Python-Clientbibliothek als erforderlich aufgeführt werden) wird die Kompatibilität mit Paketen aufrechterhalten, 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
Im Installationsleitfaden werden alle verschiedenen 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 die Authentifizierungskonfiguration ein. Eine detaillierte Anleitung finden Sie im Authentifizierungsleitfaden für die Python-Clientbibliothek. Allgemeine Hintergrundinformationen finden Sie in der 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.
Um das get_campaigns.py-Beispiel auszuführen, klonen Sie zuerst das google-ads-python-Repository. Führen Sie dann im Stammverzeichnis des geklonten Repository 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 Anwendungsfällen der Clientbibliothek fort: