Mit Clientbibliotheken können Sie programmatisch auf Cloud de Confiance by S3NS APIs zugreifen. Dabei ist weniger Boilerplate-Code erforderlich, da die Authentifizierung und die Low-Level-Serverkommunikation übernommen werden. In diesem Dokument werden die folgenden Methoden für die Interaktion mitCloud de Confiance -APIs beschrieben:
- Cloud-Clientbibliotheken (empfohlen)
- Google API-Clientbibliotheken
- Die Firebase-Entwicklungsplattform
- Ihr eigener Client-Code
Informationen zu Clientbibliotheken für ein bestimmtes Cloud de Confiance Produkt finden Sie im Abschnitt zu Clientbibliotheken in der Dokumentation des jeweiligen Produkts.
Cloud-Clientbibliotheken
Sie können zwar Cloud de Confiance by S3NS APIs direkt verwenden, indem Sie Rohanfragen an den Server senden, aber Cloud-Clientbibliotheken bieten Vereinfachungen, die den zu schreibenden Code erheblich reduzieren. Cloud-Clientbibliotheken sind die empfohlene Option für den programmatischen Zugriff auf Cloud APIs, da sie das aktuelle Clientbibliotheksmodell verwenden und folgende Vorteile bieten:
- Stellen Sie in jeder Sprache idiomatischen Code bereit, damit die Cloud de Confiance APIs intuitiv zu verwenden sind.
- Einheitlicher Stil in allen Clientbibliotheken, um die Arbeit mit mehreren Cloud de Confiance by S3NS Diensten zu vereinfachen.
- Sie übernehmen alle Low-Level-Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Kann mit bekannten Paketverwaltungstools wie
npmundpipinstalliert werden. - In einigen Fällen kann die Verwendung von gRPC die Leistung verbessern. Weitere Informationen finden Sie unter gRPC APIs.
Die Installationsanleitung und Referenzmaterialien für Cloud-Clientbibliotheken hängen von der jeweiligen Cloud de Confiance API und der verwendeten Programmiersprache ab. Weitere Informationen finden Sie in der Dokumentation für das jeweilige Cloud de Confiance 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 Cloud de Confiance by S3NS API-Bibliothek.
Google API-Clientbibliotheken
Wenn für Ihre bevorzugte Sprache für eine bestimmte API keine Cloud-Clientbibliotheken verfügbar sind, können Sie die Google API-Clientbibliotheken verwenden. Dies sind ältere Clientbibliotheken, die von Google bereitgestellt werden.
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 möglicherweise nicht so idiomatisch ist wie die Cloud-Clientbibliotheken.
- Sie übernehmen alle Low-Level-Details der Kommunikation mit dem Server, einschließlich der Authentifizierung bei Google.
- Kann mit bekannten Paketverwaltungstools wie
npmundpipinstalliert werden.
Firebase-Entwicklungsplattform verwenden
Firebase ist die Plattform von Google mit Diensten, die den gesamten App-Entwicklungszyklus unterstützen. Es bietet plattformübergreifende SDKs, mit denen Sie und KI-Agents Apps für Apple-Plattformen, Android, das Web, Flutter, Unity und C++ erstellen und ausführen können.
Informationen zu den unterstützten Cloud de Confiance APIs und zum Einstieg in Firebase finden Sie in der Firebase-Dokumentation.
Eigenen Clientcode verwenden
Wenn Sie ein erfahrener Entwickler sind und die Cloud-Clientbibliotheken Ihre spezifischen Anforderungen nicht erfüllen, können Sie Ihren eigenen benutzerdefinierten Code schreiben, um direkt auf die APIs der niedrigeren Ebene des Dienstes zuzugreifen.
REST/HTTP APIs
Alle Cloud de Confiance APIs bieten eine JSON/REST-Schnittstelle. Wenn Sie eigenen benutzerdefinierten Code schreiben müssen, um mit einer HTTP-Clientbibliothek eines Drittanbieters direkt auf die REST API zuzugreifen, finden Sie weitere Informationen dazu, wie Cloud de Confiance APIs mit verschiedenen HTTP-Versionen und ‑Implementierungen funktionieren, in den HTTP-Richtlinien.
gRPC APIs
gRPC ist ein sprach- und plattformneutrales Open-Source-System für Remote-Prozeduraufrufe (RPC), das ursprünglich von Google entwickelt wurde. Weitere Informationen finden Sie unter grpc.io. gRPC-fähige Cloud de Confiance 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 Abschnitt „APIs und Referenz“ nachsehen.
Wenn eine Cloud de Confiance API für gRPC aktiviert ist, können Sie Ihre eigenen gRPC-Clientbibliotheken dafür in jeder von gRPC unterstützten Sprache generieren. Dazu benötigen Sie die Protocol Buffers-Dienstdefinition der API, die in der Regel im Repository auf GitHub verfügbar ist.
Anschließend können Sie der Anleitung für Ihre bevorzugte Sprache auf grpc.io folgen, um Ihren Client zu generieren und zu verwenden.
Wenn Sie keinen eigenen gRPC-Code generieren möchten, können Sie trotzdem von gRPC profitieren: Eine wachsende Zahl von Cloud-Clientbibliotheken für gRPC-fähige APIs verwendet gRPC „unter der Haube“, um mit den Servern von Google zu kommunizieren. Dies ist in Bezug auf Durchsatz und CPU-Auslastung deutlich effizienter. Der Zugriff auf eine API über gRPC kann den Durchsatz pro CPU im Vergleich zur JSON REST API um das Zehnfache steigern. Google plant, so viele Cloud-Clientbibliotheken wie möglich auf gRPC umzustellen. In der Zwischenzeit profitieren Sie weiterhin von allen anderen Vorteilen des Clientbibliotheks-Codes von Google.
Weitere Möglichkeiten des Zugriffs auf Cloud APIs
Wenn Sie nicht programmgesteuert auf eine API zugreifen möchten, können Sie auf einige der gleichen Funktionen mit den Tools in der Google Cloud CLI oder über die Cloud de Confiance -Konsole zugreifen.