Les bibliothèques clientes facilitent l'accès API Google Cloud dans une langue acceptée. Vous pouvez utiliser les API Google Cloud directement en envoyant des requêtes brutes au serveur, les bibliothèques clientes permettent de simplifier ce qui réduit considérablement la quantité de code à écrire.
Ce document décrit les différents types de bibliothèques clientes que Google fournit pour les API 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
Bibliothèques clientes Cloud sont l'option recommandée pour accéder APIs Cloud de manière automatisée, où disponibles. Les bibliothèques clientes Cloud utilisent le dernier modèle de bibliothèque cliente et:
- Fournissez un code idiomatique dans chaque langage pour que les APIs Cloud soient simples et intuitives.
- Fournissez un style cohérent dans les bibliothèques clientes pour simplifier l'utilisation de plusieurs services Cloud.
- Gérer tous les détails de bas niveau de la communication avec le serveur, y compris s'authentifier 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 les instructions d'installation et les supports de référence la bibliothèque cliente Cloud sur la page "Bibliothèques clientes" 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 langues. Si vous souhaitez utiliser l'une de ces API dans la bibliothèque cliente Cloud de votre langage préféré, vous pouvez toujours utiliser la de la bibliothèque cliente, appelé Bibliothèques clientes pour les 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 ;
- disposent d'un code d'interface généré automatiquement qui n'est peut-être pas aussi idiomatique que bibliothèques clientes Cloud.
- Gérer tous les détails de bas niveau de la communication avec le serveur, y compris s'authentifier avec Google.
- peuvent être installées à l'aide d'outils de gestion de packages connus, tels que
npmetpip
Ces bibliothèques sont accessibles via des liens sur la page "Bibliothèques clientes" du domaine API.
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 Cloud pertinentes pour les mobiles à partir d'applications iOS, Android et Web. Pour en savoir plus sur les API 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 respectent pas vos vous pouvez écrire votre propre code personnalisé pour accéder les 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 API 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. Vous trouverez plus d'informations à ce sujet à l'adresse grpc.io. APIs Cloud pour lesquelles gRPC est activé ont généralement des interfaces REST et RPC. que d'utiliser JSON sur HTTP pour communiquer avec l'interface REST, l'API compatible avec gRPC les clients peuvent également utiliser tampons de protocole et gRPC sur HTTP2 pour communiquer avec l'interface RPC. Vous pouvez savoir si une API compatible avec gRPC en consultant 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 dans un langage reconnu par gRPC. Pour ce faire, vous avez besoin tampons de protocole la définition du service (généralement disponible sur 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. C'est beaucoup en termes de débit et d'utilisation du processeur, en accédant à une API l'utilisation de gRPC peut augmenter le débit par processeur jusqu'à un facteur de 10 à l'API REST JSON. Google prévoit de mettre à niveau autant de bibliothèques clientes Cloud pour gRPC ; En attendant, vous continuerez à bénéficier de tous les autres avantages le code de la bibliothèque cliente 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 console Google Cloud.