Les bibliothèques clientes vous permettent d'accéder aux API Google Cloud de manière programmatique avec moins de code récurrent en gérant l'authentification et la communication de bas niveau avec le serveur. Ce document explique les méthodes suivantes pour interagir avec les APIGoogle Cloud :
- Bibliothèques clientes Cloud (recommandé)
- Bibliothèques clientes des API Google
- La plate-forme de développement Firebase
- Votre propre code client
Pour trouver des informations sur les bibliothèques clientes d'un produit Google Cloud spécifique, consultez la section "Bibliothèques clientes" de la documentation de ce produit.
Bibliothèques clientes Google Cloud
Bien que vous puissiez utiliser directement les API Google Cloud en envoyant des requêtes brutes au serveur, les bibliothèques clientes Cloud fournissent des simplifications qui réduisent considérablement la quantité de code à écrire. Les bibliothèques clientes Cloud sont l'option recommandée pour accéder APIs Cloud de manière programmatique, car elles utilisent le dernier modèle de bibliothèque cliente et :
- Fournissez du code idiomatique dans chaque langue 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érer tous les détails de bas niveau de la communication avec le serveur, y compris l'authentification avec Google.
- Peut être installé à l'aide d'outils de gestion de packages courants tels que
npmetpip. - Dans certains cas, elles offrent des performances accrues grâce à 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 de l'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 sans frais pour exécuter, tester et déployer des charges de travail.
Profiter d'un essai sans fraisBibliothèques clientes des API Google
Si les bibliothèques clientes Cloud ne sont pas disponibles dans votre langue 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 ;
- avoir un code d'interface généré automatiquement qui n'est peut-être pas aussi idiomatique que les bibliothèques clientes Cloud.
- Gérer tous les détails de bas niveau de la communication avec le serveur, y compris l'authentification avec Google.
- Peut être installé à l'aide d'outils de gestion de packages courants tels que
npmetpip.
Utiliser la plate-forme de développement Firebase
Firebase est une plate-forme de services Google conçue pour prendre en charge l'intégralité du cycle de vie du développement de votre application. Il fournit des SDK multiplates-formes pour vous aider, vous et 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 Google Cloud compatibles et sur la façon de commencer à utiliser 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 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 du service.
API REST/HTTP
Toutes les API Google Cloud exposent une interface JSON/REST. Si vous devez écrire votre propre code personnalisé pour accéder directement à l'API REST à l'aide d'une bibliothèque cliente HTTP tierce, vous trouverez plus d'informations 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, Remote Procedure Call) Open Source, neutre en termes de langage et de plate-forme, initialement développé chez Google. Pour en savoir plus, consultez grpc.io. Les API compatibles avec gRPC Google Cloud 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. Pour savoir si une API est compatible avec gRPC, consultez la section "API et documentation de référence".
Si une API Google 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 aurez besoin de la définition du service protocol buffers de l'API (généralement disponible dans le dépôt sur GitHub).
Vous pouvez ensuite suivre les instructions dans la langue 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 profiter de gRPC : un nombre croissant de bibliothèques clientes Cloud pour les API compatibles avec gRPC utilisent gRPC "en coulisses" 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 multiplier le débit par processeur par 10 par rapport à l'API REST JSON. Google prévoit de migrer autant de bibliothèques clientes Cloud que possible vers gRPC. En attendant, vous continuerez de bénéficier de tous les autres avantages du code de la bibliothèque cliente de Google.
Autres moyens d'accéder aux API Cloud
Si vous ne souhaitez pas accéder à une API de manière programmatique, vous pouvez accéder à certaines des mêmes fonctionnalités à l'aide des outils de la Google Cloud CLI ou de la consoleGoogle Cloud .