Erläuterung zu Clientbibliotheken

Clientbibliotheken erleichtern den Zugriff auf Google Cloud APIs mit einer unterstützten Sprache. Sie können Google Cloud APIs direkt verwenden, indem Sie Rohanfragen an den Server senden. Clientbibliotheken bieten jedoch Vereinfachungen, die den zu schreibenden Code erheblich reduzieren.

In diesem Dokument werden die verschiedenen Arten von Clientbibliotheken erläutert, die Google für Cloud APIs bereitstellt. Weitere Informationen zu den verfügbaren Bibliotheken für Ihr Produkt oder für die Sprache Ihrer Wahl finden Sie in der Dokumentation des Produkts oder der Sprache.

Cloud-Clientbibliotheken

Cloud-Clientbibliotheken sind die empfohlene Option für den programmatischen Zugriff auf Cloud APIs, sofern verfügbar. Cloud-Clientbibliotheken basieren auf dem aktuellen Clientbibliotheksmodell und bieten folgende Vorteile:

• Sie stellen idiomatischen Code in den einzelnen Sprachen bereit, um die einfache und intuitive Nutzung der Cloud APIs zu gewährleisten.
• Sorgen Sie für einen einheitlichen Stil in allen Clientbibliotheken, um die Arbeit mit mehreren Cloud-Diensten zu vereinfachen.
• Sie verarbeiten alle Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
• Kann mit bekannten Paketverwaltungstools wie npm und pip installiert werden.
• Sie bieten mitunter durch die Verwendung von gRPC eine gesteigerte Leistung. Weitere Informationen finden Sie in den gRPC APIs.

Eine Installationsanleitung sowie Referenzmaterial zur entsprechenden Cloud-Clientbibliothek finden Sie auf der Seite für die Clientbibliotheken der von Ihnen verwendeten Cloud APIs. Links zu ersten Schritten mit den Cloud-Clientbibliotheken und zu ihrer Referenzdokumentation erhalten Sie auf der Seite Google Cloud-Clientbibliotheken.

Google API-Clientbibliotheken

Für einige Google Cloud APIs sind nicht in allen Sprachen Cloud-Clientbibliotheken verfügbar. Wenn Sie eine dieser APIs verwenden möchten und es keine Cloud-Clientbibliothek für Ihre bevorzugte Sprache gibt, können Sie die bisherige Clientbibliothek verwenden, die als Google API-Clientbibliotheken bezeichnet wird. Sie können diese Bibliotheken auch verwenden, wenn Sie ein Projekt aktualisieren, in dem sie bereits verwendet werden. Die Bibliotheken haben folgende Eigenschaften:

• Sie bieten nur Zugriff auf die REST-Schnittstelle der API. gRPC wird nicht unterstützt.
• Sie haben automatisch generierten Schnittstellencode, der mitunter weniger idiomatisch als in den Cloud-Clientbibliotheken ist.
• Sie verarbeiten alle Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
• Kann mit bekannten Paketverwaltungstools wie npm und pip installiert werden.

Diese Bibliotheken sind auf der Seite „Clientbibliotheken“ für die entsprechenden Cloud APIs verlinkt.

Mobile Firebase-Plattform verwenden

Firebase ist die allgemeine Google-Lösung zum Erstellen von Anwendungen auf Mobilgeräten. Das Tool bietet ein SDK mit Clientcode, mit dem Sie von iOS-, Android- und Web-Apps aus auf die für Mobilgeräte relevanten Cloud APIs zugreifen können. Weitere Informationen zu den unterstützten Cloud APIs und den ersten Schritten mit Firebase finden Sie in der Firebase-Dokumentation.

Eigenen Clientcode verwenden

Wenn Sie ein erfahrener Entwickler sind und die Clientbibliotheken von Google Ihren spezifischen Anforderungen nicht gerecht werden, können Sie eigenen benutzerdefinierten Code schreiben, um direkt auf die untergeordneten Dienst-APIs zuzugreifen.

REST/HTTP APIs

Alle Cloud APIs bieten eine einfache herkömmliche JSON/REST-Schnittstelle. Wenn Sie jedoch Ihren eigenen benutzerdefinierten Code schreiben, um über die HTTP-Clientbibliothek eines Drittanbieters direkt auf die REST API zuzugreifen, finden Sie in den HTTP-Richtlinien weitere Informationen zur Funktionsweise von Cloud APIs mit verschiedenen HTTP-Versionen und -Implementierungen.

gRPC APIs

gRPC ist ein sprach- und plattformunabhängiges Open-Source-RPC-System (Remote Procedure Call), das ursprünglich von Google entwickelt wurde. Weitere Informationen finden Sie unter grpc.io. gRPC-kompatible Cloud APIs haben in der Regel sowohl REST- als auch RPC-Schnittstellen. Anstatt nur JSON über HTTP für die Kommunikation mit der REST-Schnittstelle zu verwenden, können gRPC-kompatible API-Clients auch Protocol Buffers und gRPC über HTTP2 für die Kommunikation mit der RPC-Schnittstelle verwenden. Ob eine API gRPC-fähig ist, können Sie im jeweiligen API- und Referenzabschnitt prüfen.

Wenn eine Cloud API gRPC-fähig ist, können Sie dafür eigene gRPC-Clientbibliotheken in einer beliebigen von gRPC unterstützten Sprache erstellen. Sie benötigen dazu die Dienstdefinition der für die API verwendeten Protocol Buffers. Diese finden Sie in der Regel in unserem GitHub-Repository. Folgen Sie dann der Anleitung für Ihre bevorzugte Sprache unter grpc.io, um den Client zu generieren und zu verwenden.

Auch wenn Sie keinen eigenen gRPC-Code generieren möchten, können Sie von gRPC profitieren. Eine wachsende Anzahl von Cloud-Clientbibliotheken für gRPC-fähige APIs verwendet gRPC im Hintergrund, um mit den Servern von Google zu kommunizieren. Dies ist hinsichtlich des Durchsatzes und der CPU-Auslastung deutlich effizienter. Durch den Zugriff auf eine API über gRPC kann der Durchsatz pro CPU gegenüber der JSON REST API um den Faktor 10 erhöht werden. Google plant, so viele Cloud-Clientbibliotheken wie möglich auf gRPC umzustellen. In der Zwischenzeit stehen Ihnen weiter alle anderen Vorteile des Clientbibliothekscodes von Google zur Verfügung.

Weitere Möglichkeiten des Zugriffs auf Cloud APIs

Wenn Sie nicht programmatisch auf eine API zugreifen möchten, können Sie die gleichen Funktionen mithilfe der Tools in der Google Cloud CLI oder über die Google Cloud Console nutzen.