Übersicht

Die Python-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf PyPI verfügbar.

Voraussetzungen

Für die Bibliothek ist Python 3.8 oder höher erforderlich.

Vorbereitung

Für die Installation der Bibliothek benötigen Sie ein Entwickler-Token und Client-Kundennummer. Eine Anleitung dazu, wie Sie diese erhalten, finden Sie in der Voraussetzungen. Die anderen erforderlichen OAuth2-Tokens werden in späteren Schritten generiert.

Laufzeit- und Abhängigkeitskompatibilität

Die Python-Clientbibliothek ist weiterhin mit den Python-Laufzeiten in die Unterstützte Versionen veröffentlicht vom Python Software Foundation mit Ausnahme von Versionen mit dem Status „feature“ oder „Vorabveröffentlichung“.

Wenn neue Versionen der Python-Laufzeit eingeführt werden, bemühen wir uns, bis zum Ende des Quartals nach der Veröffentlichung eine neue Version der Python-Clientbibliothek zu veröffentlichen, die mit der neuesten Laufzeit kompatibel ist. Wenn beispielsweise eine neue Laufzeit im Oktober veröffentlicht wird, wird eine kompatible Version der Python-Client-Bibliothek bis Ende März des Folgejahres verfügbar sein.

Python-Laufzeiten, die das End of Life (EOL) erreicht haben, werden nach dem End of Life-Datum im Abschnitt Nicht unterstützte Versionen von python.org nicht mehr unterstützt.

Wir können jederzeit nach dem Ende der Lebensdauer eine Version der Python-Clientbibliothek veröffentlichen, die nicht mit nicht unterstützten Python-Laufzeiten kompatibel ist.

Für Abhängigkeiten (insbesondere alle von Google verwalteten Pakete, die als erforderlich aufgeführt der Python-Clientbibliothek), bleiben wir mit Paketen kompatibel, die werden von Google verwaltet und gelten als „unterstützt“. gemäß den OSS-Richtlinie zu funktionsgefährdenden Änderungen.

Eine vollständige Liste der unterstützten Python-Laufzeiten und -Abhängigkeiten finden Sie in der Seite Abhängigkeiten.

Installation

Folgen Sie der Anleitung in unserer Installationsdokumentation, um die Bibliothek über PyPi zu installieren, und kehren Sie dann zu dieser Seite zurück.

Konfiguration

Nachdem Sie die Bibliothek installiert haben, müssen Sie eine Konfiguration für . Es gibt mehrere Möglichkeiten zur Konfiguration der Bibliothek, die in unserer Konfiguration.

Authentifizierung

Nachdem Sie einen Konfigurationstyp ausgewählt haben, können Sie mit dem Generieren der verbleibenden OAuth2-Tokens fortfahren, die für Anfragen an die API erforderlich sind. Es gibt mehrere OAuth2-Abläufe unterstützt, die in der folgenden Liste dokumentiert sind. Weitere Informationen zu die Unterschiede zwischen den Abläufen und helfen bei der Entscheidung, welcher finden Sie in der OAuth.

API-Anfrage stellen

Sobald Sie Ihre OAuth2-Tokens in Ihre Konfiguration integriert haben, um eine API-Anfrage zu senden. Weitere Informationen finden Sie im get campaigns-Beispiel für eine einfache Möglichkeit zu testen, ob die Bibliothek ordnungsgemäß konfiguriert ist, damit die API -Anfragen.

Zum Ausführen des Beispiels get_campaigns.py im Stammverzeichnis Ihres lokalen googleads-python-Clientbibliothek installiert haben, führen Sie den folgenden Befehl aus:

$ python examples/basic_operations/get_campaigns.py -c \
  INSERT_YOUR_CUSTOMER_ID_HERE

Zusätzliche Ressourcen

Nachdem Sie eine API-Anfrage senden können, können Sie die Clientbibliothek für folgende Zwecke verwenden: