Les bibliothèques clientes facilitent l'accès aux APIGoogle Cloud à l'aide d'un langage compatible. 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 décrit les différents types de bibliothèques clientes que Google fournit pour les APIs Cloud. Pour en savoir plus sur les bibliothèques disponibles pour votre produit ou le langage de votre choix, consultez la documentation correspondante.
Bibliothèques clientes Google Cloud
Les bibliothèques clientes Cloud sont une 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 l'utilisation des APIs Cloud simple et intuitive ;
- Fournissez un style cohérent dans les bibliothèques clientes pour simplifier l'utilisation de plusieurs services 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 les API gRPC.
Vous trouverez des instructions d'installation et des documents de référence pour la bibliothèque cliente Cloud sur la page "Bibliothèques clientes" des API Cloud que vous utilisez. Vous trouverez des liens pour vous familiariser avec les bibliothèques clientes Cloud et leur documentation de référence sur la page Bibliothèques clientes 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
Certaines API Google Cloud ne disposent pas de bibliothèques clientes Cloud disponibles pour tous les langages. Si vous souhaitez utiliser l'une de ces API et qu'il n'existe pas de bibliothèque cliente Cloud pour votre langage préféré, vous pouvez toujours utiliser l'ancien style de bibliothèque cliente, appelé bibliothèques clientes de l'API 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;
Ces bibliothèques sont disponibles sur la page "Bibliothèques clientes" des API Cloud concernées.
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 APIs Cloud pertinentes pour les mobiles à partir d'applications iOS, Android et Web. Pour en savoir plus sur les APIs 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 de Google 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 Cloud présentent une interface JSON/REST traditionnelle et simple. 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 APIs 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, neutre en termes de langage et de plate-forme, initialement développé chez Google. Pour en savoir plus, consultez grpc.io. APIs Cloud 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 tampons de protocole 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 API 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 tout de même bénéficier de gRPC. Un nombre croissant de bibliothèques clientes Google 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 .