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 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 Foundation veröffentlicht wurde. 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 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. 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.
Bei Abhängigkeiten (insbesondere alle von Google verwalteten Pakete, die als erforderlich für die Python-Clientbibliothek aufgeführt sind) wird die Kompatibilität mit Paketen aufrechterhalten, die von Google verwaltet werden und gemäß der Google OSS-Richtlinie für funktionsgefährdende Änderungen 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 verschiedenen Möglichkeiten zum
Installieren 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 in der Konfigurationsanleitung beschrieben.
Authentifizierung
Nachdem Sie einen Konfigurationsansatz ausgewählt haben, richten Sie die Authentifizierungskonfiguration ein. Eine detaillierte Anleitung finden Sie in der Anleitung zur Authentifizierung der 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 Kampagnen abrufen erfahren Sie, wie Sie schnell testen können, ob die Bibliothek richtig konfiguriert ist, um API-Anfragen zu stellen.
Um das Beispiel get_campaigns.py auszuführen, 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 diesen Verwendungszwecken der Clientbibliothek fort: