Bien que vous puissiez utiliser Google Cloud directement les API en envoyant des requêtes brutes au serveur, les bibliothèques clientes vous simplifient la tâche en réduisent considérablement la quantité de code à écrire.
Ce document explique les méthodes d'interaction avec les Google Cloud API :
- Bibliothèques clientes Cloud (recommandé)
- Bibliothèques clientes pour les API Google
- Firebase Mobile
- Votre propre code client
Pour trouver des informations sur la bibliothèque cliente d'un produit spécifique Google Cloud , consultez la section "Bibliothèques clientes" de la documentation de ce produit. Pour afficher toutes les bibliothèques clientes Cloud, souvent organisées par langage compatible, consultez la page Bibliothèques clientes Cloud.
Bibliothèques clientes Cloud
Les bibliothèques clientes Cloud sont l'option recommandée pour accéder par programmation APIs Cloud, le cas échéant. Les bibliothèques clientes Cloud utilisent le dernier modèle de bibliothèque cliente et :
- fournissent un code idiomatique dans chaque langage pour rendre les Google Cloud API intuitives à utiliser ;
- offrent un style cohérent dans toutes les bibliothèques clientes pour simplifier l'utilisation de plusieurs Google Cloud services ;
- gèrent tous les détails de bas niveau de la communication avec le serveur, y compris l'authentification avec Google.
- peuvent être installées à l'aide d'outils de gestion de package connus tels que
npmetpip; - permettent, dans certains cas, d'optimiser les performances à l'aide de gRPC. Pour en savoir plus, consultez la section API gRPC.
Les instructions d'installation et les documents de référence pour les bibliothèques clientes Cloud dépendent de l'API spécifique Google Cloud et du langage de programmation que vous utilisez. Pour trouver ces informations, consultez la documentation du produit Google Cloud spécifique. La plupart des produits incluent une section "Bibliothèques clientes" dans leur documentation, qui fournit des conseils spécifiques à chaque langage, des étapes d'installation et des liens vers la documentation de référence détaillée de l'API.
Vous pouvez trouver la documentation d'un produit spécifique en parcourant la Google Cloud bibliothèque d'API.
Faites l'essai
Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.
Essai sans fraisBibliothèques clientes pour les API Google
Si les bibliothèques clientes Cloud ne sont pas disponibles dans le langage de votre choix pour une API spécifique, vous pouvez utiliser les bibliothèques clientes pour les API Google. Il s'agit d'un type de bibliothèque cliente plus ancien fourni par Google.
Vous pouvez également utiliser ces bibliothèques si vous mettez à niveau un projet qui les utilise déjà. Ces bibliothèques :
- donnent uniquement accès à l'interface REST de l'API, gRPC n'étant pas compatible ;
- possèdent un code d’interface généré automatiquement qui peut ne pas être aussi idiomatique que les bibliothèques clientes Cloud ;
- gèrent tous les détails de bas niveau de la communication avec le serveur, y compris l'authentification avec Google.
- peuvent être installées à l'aide d'outils de gestion de package connus tels que
npmetpip.
Utiliser la plate-forme de développement Firebase
Firebase est la plate-forme de services de Google conçue pour prendre en charge l'ensemble du cycle de vie de développement de votre application. Elle fournit des SDK multiplates-formes pour vous aider, ainsi que les agents d'IA, à créer et à exécuter des applications pour les plates-formes Apple, Android, le Web, Flutter, Unity et C++.
Pour en savoir plus sur les API compatibles Google Cloud et sur les premiers pas avec Firebase, consultez la documentation Firebase .
Utiliser votre propre code client
Si vous êtes un développeur expérimenté et que les bibliothèques clientes Cloud ne répondent pas à vos besoins spécifiques, vous pouvez écrire votre propre code pour accéder directement aux API de service de niveau inférieur.
API REST/HTTP
Toutes les Google Cloud API présentent une interface JSON/REST. Si vous devez écrire votre propre code pour accéder directement à l'API REST à l'aide d'une bibliothèque cliente HTTP tierce, vous pouvez en savoir plus sur le fonctionnement des Google Cloud API avec différentes versions et mises en œuvre HTTP dans les consignes HTTP.
API gRPC
gRPC est un système d'appel de procédure à distance (RPC) Open Source et indépendant du langage et de la plate-forme, initialement développé par Google. Vous pouvez en apprendre davantage à ce sujet à l'adresse grpc.io. Les API compatibles avec gRPC Google Cloud ont généralement à la fois des interfaces REST et RPC . Ainsi, plutôt que d'utiliser simplement JSON sur HTTP pour communiquer avec l'interface REST, les clients de l'API compatibles gRPC peuvent également utiliser Protocol Buffers et gRPC sur HTTP2 pour communiquer avec l'interface RPC. Vous pouvez savoir si une API est compatible avec gRPC en consultant sa section "API et documentations de référence".
Si une Google Cloud API est compatible avec gRPC, vous pouvez générer vos propres bibliothèques clientes gRPC dans un langage reconnu par gRPC. Pour cela, vous aurez besoin de la définition de service Protocol Buffers de l'API (généralement disponible dans le dépôt sur GitHub).
Vous pouvez ensuite suivre les instructions de votre langage préféré sur grpc.io pour générer et utiliser votre client.
Si vous ne souhaitez pas générer votre propre code gRPC, vous pouvez toujours bénéficier de gRPC. Un nombre croissant de bibliothèques clientes Cloud pour les API compatibles avec gRPC utilisent gRPC "sous le capot" pour communiquer avec les serveurs de Google. Cela est beaucoup plus efficace en termes de débit et d'utilisation du processeur. L'accès à une API à l'aide de gRPC peut augmenter le débit par processeur jusqu'à 10 fois par rapport à l'API REST JSON. Google prévoit de mettre à niveau vers gRPC autant de bibliothèques clientes Cloud que possible. En attendant, vous continuez de bénéficier de tous les autres avantages du code de bibliothèque cliente de Google.
Autres moyens d'accéder APIs Cloud
Si vous ne souhaitez pas accéder à une API de façon programmatique, vous pouvez accéder à certaines des mêmes fonctionnalités à l'aide des outils de Google Cloud CLI ou à l'aide de la Google Cloud console.