Les bibliothèques clientes facilitent l'accès aux API Google Cloud à partir d'un langage compatible. Bien que vous puissiez utiliser les API Google Cloud directement en envoyant des requêtes brutes au serveur, les bibliothèques clientes offrent 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 le produit ou le langage de votre choix, consultez la documentation du produit ou du langage concerné.
Bibliothèques clientes Google Cloud
Les bibliothèques clientes Cloud constituent l'option recommandée pour accéder APIs Cloud de manière automatisée, le cas échéant. Les bibliothèques clientes Cloud utilisent le dernier modèle de bibliothèque cliente et:
- Fournissez un code idiomatique dans chaque langage pour rendre les APIs Cloud simples et intuitives à utiliser.
- Fournissez un style cohérent dans toutes les bibliothèques clientes pour simplifier l'utilisation de plusieurs services Cloud.
- Gérez 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 packages courants tels que
npmetpip; - vous permettre dans certains cas d'améliorer les performances en utilisant gRPC ; Pour en savoir plus, consultez la section 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
Quelques API Google Cloud ne disposent pas de bibliothèques clientes Cloud disponibles dans tous les langages. Si vous souhaitez utiliser l'une de ces API et qu'il n'existe pas de bibliothèque cliente Cloud pour le langage de votre choix, vous pouvez toujours utiliser l'ancien style de bibliothèque cliente, appelé bibliothèques clientes des API Google. Vous pouvez également vous servir de 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 ;
- disposent d'un code d'interface généré automatiquement qui peut ne pas être aussi idiomatique que les bibliothèques clientes Cloud ;
- Gérez 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 packages courants tels que
npmetpip;
Ces bibliothèques sont accessibles via des liens 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 des appareils mobiles. Elle propose un SDK avec un code client qui vous permet d'accéder APIs Cloud adaptées aux mobiles à partir d'applications iOS, Android et Web. Pour en savoir plus sur les APIs Cloud compatibles et faire vos premiers pas avec Firebase, consultez la documentation de 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 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 personnalisé pour accéder directement à l'API REST à l'aide d'une bibliothèque cliente HTTP tierce, consultez les consignes HTTP pour en savoir plus sur le fonctionnement des APIs Cloud avec différentes versions et implémentations HTTP.
API gRPC
gRPC est un système Open Source d'appel de procédure à distance (RPC) indépendant du langage et de la plate-forme, initialement développé par Google. Vous pouvez le découvrir sur grpc.io. APIs Cloud compatibles avec gRPC ont généralement des interfaces REST et RPC. Par conséquent, au lieu d'utiliser JSON sur HTTP pour communiquer avec l'interface REST, les clients API compatibles avec gRPC peuvent également utiliser des tampons de protocole et gRPC sur HTTP2 pour communiquer avec l'interface RPC. Pour savoir si une API est compatible avec gRPC, consultez sa section "API et documentation de référence".
Si une API Cloud est compatible avec gRPC, vous pouvez générer vos propres bibliothèques clientes gRPC pour celle-ci dans n'importe quel langage compatible avec gRPC. Pour ce faire, vous avez besoin de la définition du service de tampons de protocole de l'API (généralement disponible dans le dépôt sur GitHub). Vous pouvez ensuite suivre les instructions du langage de votre choix 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 Cloud pour les API compatibles avec gRPC utilisent gRPC "en arrière-plan" pour communiquer avec les serveurs de Google. Cette méthode est considérablement 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'à un facteur de 10 par rapport à l'API REST JSON. Google prévoit de mettre à niveau le plus grand nombre possible de bibliothèques clientes Cloud vers gRPC. En attendant, vous bénéficiez toujours de tous les autres avantages du code des bibliothèques clientes de Google.
Autres moyens d'accéder aux API Cloud
Si vous ne souhaitez pas accéder à une API par programmation, vous pouvez accéder à certaines de ces fonctionnalités à l'aide des outils de Google Cloud CLI ou de la console Google Cloud.