google api python client

Google API-Client

Dies ist die Google API-Python-Clientbibliothek für die Discovery-basierten APIs von Google. Um zu beginnen, sehen Sie sich bitte den Ordner „Dokumente“ an.

Diese Bibliothek gilt als vollständig und befindet sich im Wartungsmodus. Das bedeutet, dass wir kritische Fehler und Sicherheitsprobleme beheben, aber keine neuen Funktionen hinzufügen.

Diese Bibliothek wird offiziell von Google unterstützt. Die Betreuer dieses Repositorys empfehlen jedoch, für die Entwicklung neuen Codes nach Möglichkeit Cloud-Client-Bibliotheken für Python zu verwenden. Weitere Informationen finden Sie unter Erläuterungen zu den Clientbibliotheken.

Version 2.0-Release

Die Version 2.0 von google-api-python-client bietet im Vergleich zu 1.x eine erhebliche Verbesserung der Zuverlässigkeit, da Discovery-Dokumente jetzt in der Bibliothek zwischengespeichert und nicht mehr dynamisch abgerufen werden. Es wird dringend empfohlen, ein Upgrade von v1.x auf v2.x durchzuführen.

Es wird nur Python 3.7 und höher unterstützt. Wenn Sie Python nicht aktualisieren können, verwenden Sie bitte weiterhin Version 1.x, da wir Python 2.7+ in Version 1 weiterhin unterstützen.

Discovery-Dokumente werden nicht mehr dynamisch abgerufen, wenn Sie discovery.build() aufrufen. Die Discovery-Dokumente werden stattdessen direkt aus der Client-Bibliothek abgerufen. Neue Versionen dieser Bibliothek werden wöchentlich veröffentlicht. Aufgrund der Zwischenspeicherung der Discovery-Dokumente ist die Größe dieses Pakets im Vergleich zur Vorgängerversion um mindestens 50 MB größer.

Weitere Informationen finden Sie im Migrationsleitfaden.

Dokumentation

Ausführlichere Anweisungen und zusätzliche Dokumentation finden Sie im Ordner „Docs“.

Andere Google API-Bibliotheken

Die Betreuer dieses Repositorys empfehlen aus folgenden Gründen, wo möglich, Cloud-Client-Bibliotheken für Python für die Entwicklung neuen Codes zu verwenden:

Mit Cloud-Client-Bibliotheken für Python:

• Für jede API gibt es eine separate Client-Bibliothek, sodass Sie auswählen können, welche Client-Bibliotheken heruntergeladen werden sollen. Dagegen ist google-api-python-client eine einzige Client-Bibliothek für alle APIs. Daher übersteigt die Gesamtpaketgröße für google-api-python-client 50 MB.
• Es gibt strengere Kontrollen für Breaking-Änderungen an den zugrunde liegenden APIs, da sich jede Clientbibliothek auf eine bestimmte API konzentriert.
• Diese Cloud-Client-Bibliotheken bieten mehr Funktionen, da sich jede Bibliothek auf eine bestimmte API konzentriert und in einigen Fällen die Bibliotheken einem Team gehören, das sich auf diese API spezialisiert hat.
• Entwickler werden von Intellisense profitieren.

Weitere Informationen finden Sie unter Erläuterungen zu den Clientbibliotheken.

Obwohl die Umstellung auf Cloud-Client-Bibliotheken für Python viele Vorteile mit sich bringt, möchten die Betreuer betonen, dass google-api-python-client weiterhin unterstützt wird.

Für die Google Ads API empfehlen wir die Verwendung der Google Ads API Client Library für Python.

Für die Google Firebase Admin API empfehlen wir die Verwendung des Firebase Admin Python SDK.

Installation

Installieren Sie diese Bibliothek mit pip in einer virtuellen Umgebung. virtualenv ist ein Tool zum Erstellen isolierter Python-Umgebungen. Das grundlegende Problem, das es anspricht, betrifft Abhängigkeiten und Versionen sowie indirekt Berechtigungen.

Mit virtualenv ist es möglich, diese Bibliothek zu installieren, ohne dass Systeminstallationsberechtigungen erforderlich sind und ohne dass es zu Konflikten mit den installierten Systemabhängigkeiten kommt.

Mac/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

Windows

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

Unterstützte Python-Versionen

Python 3.7, 3.8, 3.9, 3.10, 3.11 und 3.12 werden vollständig unterstützt und getestet. Diese Bibliothek funktioniert möglicherweise auf späteren Versionen von 3, aber wir führen derzeit keine Tests mit diesen Versionen durch.

Nicht unterstützte Python-Versionen

Python < 3.7

Bibliotheken und Abhängigkeiten von Drittanbietern

Die folgenden Bibliotheken werden installiert, wenn Sie die Client-Bibliothek installieren:

• httplib2
• uritemplate

Für die Entwicklung benötigen Sie außerdem folgende Bibliotheken:

• WebTest
• pyopenssl

Mitwirken

Bitte beachten Sie unseren Beitragsleitfaden. Insbesondere lieben wir Pull-Anfragen – aber bitte stellen Sie sicher, dass Sie die Mitwirkenden-Lizenzvereinbarung unterzeichnen.