Sie können zwar Google Cloud APIs direkt verwenden, indem Sie Rohdatenanfragen an den Server senden, aber Clientbibliotheken bieten Vereinfachungen, die den zu schreibenden Code erheblich reduzieren.
In diesem Dokument werden Methoden für die Interaktion mit Google Cloud APIs beschrieben:
- Cloud-Clientbibliotheken (empfohlen)
- Google API-Clientbibliotheken
- Firebase Mobile
- Ihr eigener Clientcode
Informationen zu Clientbibliotheken für ein bestimmtes Google Cloud -Produkt finden Sie im Abschnitt zu Clientbibliotheken in der Dokumentation des jeweiligen Produkts. Eine Liste aller Cloud-Clientbibliotheken, die oft nach unterstützter Sprache organisiert sind, finden Sie unter Cloud-Clientbibliotheken.
Cloud-Clientbibliotheken
Cloud-Clientbibliotheken sind die empfohlene Option für den programmatischen Zugriff auf Cloud APIs, falls verfügbar. Cloud-Clientbibliotheken basieren auf dem aktuellen Clientbibliotheksmodell und bieten folgende Vorteile:
- Sie stellen idiomatischen Code in den einzelnen Sprachen bereit, um die intuitive Nutzung der Google Cloud APIs zu gewährleisten.
- Einheitlicher Stil in allen Clientbibliotheken, um die Arbeit mit mehreren Google Cloud -Diensten zu vereinfachen.
- Sie verarbeiten alle Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Kann mit bekannten Paketverwaltungstools wie
npmundpipinstalliert werden. - Sie bieten mitunter durch die Verwendung von gRPC eine gesteigerte Leistung. Weitere Informationen finden Sie unter gRPC-APIs.
Die Installationsanleitung und das Referenzmaterial für Cloud-Clientbibliotheken hängen von der jeweiligen Google Cloud API und der von Ihnen verwendeten Programmiersprache ab. Weitere Informationen finden Sie in der Dokumentation für das jeweilige Google Cloud Produkt. Die meisten Produkte enthalten in ihrer Dokumentation einen Abschnitt „Clientbibliotheken“ mit sprachspezifischen Anleitungen, Installationsschritten und Links zur detaillierten API-Referenz.
Die Dokumentation für ein bestimmtes Produkt finden Sie in der Google Cloud API-Bibliothek.
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie 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
Wenn für eine bestimmte API keine Cloud-Clientbibliotheken für Ihre bevorzugte Sprache verfügbar sind, können Sie die Google API-Clientbibliotheken verwenden. Dies ist eine ältere Art von Clientbibliothek, die von Google bereitgestellt 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
npmundpipinstalliert werden.
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 direkt von iOS-, Android- und Web-Apps aus auf die für Mobilgeräte relevanten Google Cloud APIs zugreifen können. Informationen zu den unterstützten Google 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 Cloud-Clientbibliotheken Ihren speziellen Anforderungen nicht gerecht werden, können Sie eigenen benutzerdefinierten Code schreiben, um auf die untergeordneten Dienst-APIs direkt zuzugreifen.
REST/HTTP APIs
Alle Google Cloud APIs bieten eine JSON/REST-Schnittstelle. Wenn Sie Ihren eigenen benutzerdefinierten Code schreiben müssen, um über die HTTP-Clientbibliothek eines Drittanbieters direkt auf die REST API zuzugreifen, finden Sie weitere Informationen zur Funktionsweise von Google Cloud APIs mit anderen HTTP-Versionen und -Implementierungen in den HTTP-Richtlinien.
gRPC APIs
gRPC ist ein sprach- und plattformneutrales Open-Source-System für Remoteprozeduraufrufe (RPC), das ursprünglich bei Google entwickelt wurde. Weitere Informationen finden Sie unter grpc.io. gRPC-fähige Google Cloud APIs haben in der Regel sowohl REST- als auch RPC-Schnittstellen. Anstatt also nur JSON über HTTP für die Kommunikation mit der REST-Schnittstelle zu verwenden, können gRPC-fähige 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 Google 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 im Repository auf GitHub.
Folgen Sie den Anleitungen 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 zu aktualisieren. In der Zwischenzeit stehen Ihnen weiter alle anderen Vorteile unseres Clientbibliothekscodes 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 -Konsole nutzen.