Bien que vous puissiez utiliser directement les API Google Cloud en envoyant des requêtes brutes au serveur, les bibliothèques clientes fournissent des simplifications qui réduisent considérablement la quantité de code à écrire.
Ce document explique les méthodes d'interaction avec les API Google Cloud :
- Bibliothèques clientes Cloud (recommandées)
- Bibliothèques clientes pour les API Google
- Firebase pour mobile
- Votre propre code client
Pour trouver des informations sur les bibliothèques clientes d'un produit Google Cloud spécifique, consultez la section sur les bibliothèques clientes dans la documentation de ce produit. Pour afficher toutes les bibliothèques clientes Cloud, souvent organisées par langage compatible, consultez Bibliothèques clientes Cloud.
Bibliothèques clientes Google Cloud
Les bibliothèques clientes Cloud sont l'option recommandée pour accéder APIs Cloud de façon automatisée, 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 API Google Cloud intuitives à utiliser ;
- Fournir un style cohérent dans les bibliothèques clientes pour simplifier l'utilisation de plusieurs services Google 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; - permettent, dans certains cas, d'optimiser les performances à l'aide de gRPC. Pour en savoir plus, consultez API gRPC.
Les instructions d'installation et les documents de référence pour les bibliothèques clientes Cloud dépendent de l'API Google Cloud spécifique 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 sur les API.
Vous pouvez trouver la documentation d'un produit spécifique en parcourant la bibliothèque d'APIGoogle Cloud .
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 gratuits pour exécuter, tester et déployer des charges de travail.
Essai gratuitBibliothèques clientes pour les API Google
Si les bibliothèques clientes Cloud ne sont pas disponibles pour votre langage préféré pour une API spécifique, vous pouvez utiliser les bibliothèques clientes des API Google. Il s'agit d'un ancien type de bibliothèque cliente 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 mobile Firebase
Firebase est la solution à l'échelle de Google pour la création d'applications sur appareils mobiles. Elle propose un SDK avec un code client qui vous permet d'accéder aux API Google Cloud pertinentes pour les mobiles à partir d'applications iOS, Android et Web. Pour en savoir plus sur les API Google Cloud compatibles 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 personnalisé pour accéder directement aux API de service de niveau inférieur.
API REST/HTTP
Toutes les API Google Cloud 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 API Google Cloud avec différentes versions et implémentations HTTP dans les consignes HTTP.
API gRPC
gRPC est un système d'appel de procédure à distance (RPC) Open Source, indépendant du langage et de la plate-forme, initialement développé chez Google. Pour en savoir plus, consultez grpc.io. Les API compatibles avec gRPC disposent généralement d'interfaces REST et RPC. Ainsi, au lieu d'utiliser uniquement JSON sur HTTP pour communiquer avec l'interface REST, les clients d'API compatibles avec gRPC peuvent également utiliser des protocol buffers et gRPC sur HTTP2 pour communiquer avec l'interface RPC. Google Cloud Vous pouvez savoir si une API est compatible avec gRPC en consultant sa section "API et documentations de référence".
Si une API Google Cloud 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 JSON/REST. Google prévoit de mettre à niveau vers gRPC autant de bibliothèques clientes Cloud que possible. En attendant, vous continuerez de bénéficier de tous les autres avantages du code de bibliothèque cliente de Google.
Autres moyens d'accéder aux API Cloud
Si vous ne souhaitez pas accéder à une API de façon automatisée, vous pouvez accéder à certaines des mêmes fonctionnalités à l'aide des outils de la Google Cloud CLI ou de la consoleGoogle Cloud .