Clientbibliotheken erleichtern den Zugriff auf Google Cloud APIs über eine unterstützte Sprache. Sie können Google Cloud APIs direkt verwenden, indem Sie unverarbeitete Anfragen an den Server senden. Clientbibliotheken bieten jedoch Vereinfachungen, durch die der zu schreibende Code erheblich reduziert wird.
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 Ihre bevorzugte Sprache finden Sie auch 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 verwenden das neueste Clientbibliotheksmodell und:
- Stellen Sie idiomatischen Code in jeder Sprache bereit, um die Nutzung der Cloud APIs einfach und intuitiv zu gestalten.
- Einheitlichen Stil für Clientbibliotheken bieten, 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 vertrauten Paketverwaltungstools wie
npmundpipinstalliert werden. - In einigen Fällen bieten Sie Leistungsvorteile durch die Verwendung von gRPC. Weitere Informationen finden Sie unter gRPC APIs.
Eine Installationsanleitung und Referenzmaterial für die Cloud-Clientbibliothek finden Sie auf der Seite der Clientbibliotheken für die von Ihnen verwendeten Cloud APIs. Links für die ersten Schritte mit den Cloud-Clientbibliotheken und ihrer 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 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 vorherige Clientbibliothek verwenden. Diese wird als Google API-Clientbibliotheken bezeichnet. Sie können diese Bibliotheken auch verwenden, wenn Sie ein Upgrade für ein Projekt ausführen, das diese Bibliotheken bereits verwendet. 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 nicht so idiomatisch ist wie die Cloud-Clientbibliotheken.
- Sie verarbeiten alle Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Kann mit vertrauten Paketverwaltungstools wie
npmundpipinstalliert werden.
Diese Bibliotheken sind auf der Seite der Clientbibliotheken für die entsprechenden Cloud APIs verlinkt.
Mobile Firebase-Plattform verwenden
Firebase ist die Google-weite Lösung zum Erstellen von Anwendungen auf Mobilgeräten. Es bietet ein SDK mit Clientcode, mit dem Sie über iOS-, Android- und Web-Apps auf Cloud-relevante Cloud APIs zugreifen können. Informationen zu den unterstützten Cloud APIs und zum Einstieg in 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 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 eine HTTP-Clientbibliothek eines Drittanbieters direkt auf die REST API zuzugreifen, erhalten Sie in den HTTP-Richtlinien weitere Informationen dazu, wie Cloud APIs mit verschiedenen HTTP-Versionen und -Implementierungen funktionieren.
gRPC APIs
gRPC ist ein sprach- und plattformneutrales Open-Source-RPC-System (Remote Procedure Call, RPC), das ursprünglich bei Google entwickelt wurde. Weitere Informationen finden Sie unter grpc.io. gRPC-fähige Cloud APIs haben in der Regel sowohl REST- als auch RPC-Schnittstellen. gRPC-fähige API-Clients können also nicht nur JSON über HTTP für die Kommunikation mit der REST-Schnittstelle verwenden, sondern auch Protokollzwischenspeicher und gRPC über HTTP2 für die Kommunikation mit der RPC-Schnittstelle. Ob eine API gRPC-fähig ist, können Sie im entsprechenden API- und Referenzabschnitt nachsehen.
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 (normalerweise im Repository auf GitHub verfügbar). 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: Immer mehr Cloud-Clientbibliotheken für gRPC-fähige APIs verwenden gRPC, um mit den Servern von Google zu kommunizieren. Dies ist im Hinblick auf den Durchsatz und die CPU-Auslastung 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 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 der gleichen Funktionen über die Tools in der Google Cloud CLI oder über die Google Cloud Console nutzen.