Clientbibliotheken erleichtern den Zugriff auf Google Cloud APIs über eine unterstützte Sprache. Während Sie Google Cloud APIs direkt verwenden können, indem Sie Rohanfragen an den Server senden, bieten Clientbibliotheken 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 das Produkt oder die Sprache Ihrer Wahl finden Sie in der Dokumentation des Produkts oder der Sprache.
Cloud-Clientbibliotheken
Für den programmatischen Zugriff auf Cloud APIs werden, sofern verfügbar, Cloud-Clientbibliotheken empfohlen. Cloud-Clientbibliotheken verwenden das neueste Clientbibliotheksmodell und:
- Sie stellen in jeder Sprache idiomatischen Code bereit, um die Nutzung von Cloud APIs einfach und intuitiv zu gestalten.
- Bereitstellung eines einheitlichen Stils für alle Clientbibliotheken, um die Arbeit mit mehreren Cloud-Diensten zu vereinfachen
- Sie verarbeiten alle Low-Level-Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Sie können mit vertrauten Paketverwaltungstools wie
npmundpipinstalliert werden. - Sie können durch die Verwendung von gRPC Leistungsvorteile erzielen. Weitere Informationen finden Sie in den gRPC APIs.
Eine Installationsanleitung und Referenzmaterial zur Cloud-Clientbibliothek finden Sie auf der Seite „Clientbibliotheken“ für die von Ihnen verwendeten Cloud APIs. Links für die ersten Schritte mit den Cloud-Clientbibliotheken und der zugehörigen Referenzdokumentation finden Sie auf der Seite Cloud-Clientbibliotheken.
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Jetzt kostenlos startenGoogle API-Clientbibliotheken
Für einige Google Cloud APIs sind Cloud-Clientbibliotheken nicht in allen Sprachen verfügbar. Wenn Sie eine dieser APIs verwenden möchten und keine Cloud-Clientbibliothek für Ihre bevorzugte Sprache vorhanden ist, können Sie weiterhin den vorherigen Stil der Clientbibliothek namens Google API-Clientbibliotheken verwenden. Sie können diese Bibliotheken auch verwenden, wenn Sie ein Upgrade für ein Projekt durchführen, 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 möglicherweise nicht so idiomatisch ist wie die Cloud-Clientbibliotheken.
- Sie verarbeiten alle Low-Level-Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Sie können mit vertrauten Paketverwaltungstools wie
npmundpipinstalliert werden.
Diese Bibliotheken sind auf der Seite „Clientbibliotheken“ für die relevanten Cloud APIs verlinkt.
Mobile Firebase-Plattform verwenden
Firebase ist die Google-weite Lösung zum Erstellen von Apps auf Mobilgeräten. Es bietet ein SDK mit Clientcode, mit dem Sie über iOS-, Android- und Web-Apps auf für Mobilgeräte relevante Cloud APIs zugreifen können. 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 nicht Ihren spezifischen Anforderungen entsprechen, können Sie Ihren eigenen benutzerdefinierten Code schreiben, um direkt auf die untergeordneten Dienst-APIs des Dienstes zuzugreifen.
REST/HTTP APIs
Alle Cloud APIs bieten eine einfache herkömmliche JSON/REST-Schnittstelle. Wenn Sie eigenen benutzerdefinierten Code schreiben müssen, 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 plattformneutrales Open-Source-RPC-System (Remote Procedure Call, Remoteprozeduraufruf), das ursprünglich bei Google entwickelt wurde. Weitere Informationen dazu finden Sie unter grpc.io. gRPC-fähige Cloud APIs haben in der Regel sowohl REST- als auch RPC-Schnittstellen. Daher können gRPC-fähige API-Clients Protokollzwischenspeicher und gRPC über HTTP2 zur Kommunikation mit der RPC-Schnittstelle verwenden, statt nur JSON über HTTP zu verwenden. Ob eine API für gRPC aktiviert ist, können Sie im zugehörigen Abschnitt „APIs und Referenzen“ prüfen.
Wenn eine Cloud API gRPC-fähig ist, können Sie eigene gRPC-Clientbibliotheken dafür in jeder von gRPC unterstützten Sprache generieren. Dazu benötigen Sie die Dienstdefinition der Protokollpuffer der API, die in der Regel im Repository auf GitHub verfügbar ist. Folgen Sie der Anleitung für Ihre bevorzugte Sprache unter grpc.io, um den Client zu generieren und zu verwenden.
Wenn Sie keinen eigenen gRPC-Code generieren möchten, können Sie trotzdem von gRPC profitieren: Immer mehr Cloud-Clientbibliotheken für gRPC-fähige APIs verwenden gRPC "unter der Haube", um mit den Servern von Google zu kommunizieren. Dies ist in Bezug auf Durchsatz und CPU-Nutzung erheblich effizienter. Der Zugriff auf eine API mit gRPC kann den Durchsatz pro CPU im Vergleich zur JSON REST API um bis zu 10 % erhöhen. Google plant, so viele Cloud-Clientbibliotheken wie möglich auf gRPC zu aktualisieren. In der Zwischenzeit können Sie trotzdem alle anderen Vorteile des Clientbibliothekscodes von Google nutzen.
Weitere Möglichkeiten des Zugriffs auf Cloud APIs
Wenn Sie nicht programmatisch auf eine API zugreifen möchten, können Sie einige derselben Funktionen mithilfe der Tools in der Google Cloud CLI oder der Google Cloud Console nutzen.