Présentation des bibliothèques clientes

Bien que les API Google Cloud permettent d'adresser des requêtes HTTP directement au serveur (ou des appels RPC, le cas échéant), nous fournissons un code de bibliothèque cliente pour toutes nos API Cloud, ce qui facilite leur accès depuis vos langages préférés. Ce document décrit les différents types de bibliothèques clientes que nous fournissons pour les API Cloud. Vous pouvez en savoir plus sur les bibliothèques disponibles pour votre produit ou le langage de votre choix dans la documentation du produit ou du langage.

Bibliothèques clientes Google Cloud

Les bibliothèques clientes Google Cloud utilisent notre dernier modèle de bibliothèque cliente et représentent une option de choix pour accéder aux API Cloud de façon automatisée, le cas échéant. Les bibliothèques clientes Google Cloud :

  • fournissent un code idiomatique, généré ou créé manuellement dans chaque langage, ce qui rend l'utilisation de l'API Cloud plus simple et intuitive ;
  • 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 npm et pip ;
  • permettent, dans certains cas, d'optimiser les performances à l'aide de gRPC. Pour plus d'informations, consultez la section API gRPC ci-dessous.

Vous pouvez trouver des instructions d'installation et des documents de référence pour la bibliothèque cliente Google Cloud appropriée sur la page Bibliothèques clientes de l'API Cloud de votre choix.

Pour presque tous les langages disponibles, vous pouvez également télécharger une bibliothèque cliente unique qui fournit une interface à toutes les API Cloud compatibles. Vous pouvez trouver des liens pour vous familiariser avec celles-ci et leur documentation de référence sur notre page Bibliothèques clientes Cloud.

Bibliothèques clientes pour les API Google

Un certain nombre d'API Google Cloud ne disposent pas encore de bibliothèques clientes Google 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 une version plus ancienne de nos bibliothèques clientes appelées bibliothèques clientes de l'API Google. 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 nos nouvelles bibliothèques ;
  • 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 npm et pip.

Vous trouverez des liens vers ces bibliothèques sur la page Bibliothèques clientes de l'API Cloud appropriée, le cas échéant.

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 directement aux API Cloud pertinentes pour les mobiles à partir d'applications iOS, Android et Web. Consultez la documentation Firebase pour plus d'informations sur les API Cloud compatibles et sur les premiers pas avec Firebase.

Utiliser votre propre code client

En règle générale, nous recommandons d’utiliser nos bibliothèques clientes pour accéder aux API Cloud. Toutefois, si vous êtes un développeur expérimenté et que nos bibliothèques clientes 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 pour accéder directement à l'API REST à l'aide d'une bibliothèque cliente HTTP tierce de votre choix, vous pouvez en savoir plus sur le fonctionnement des API Cloud avec différentes versions et mises en œuvres HTTP dans nos consignes HTTP.

API gRPC

gRPC est un système d'appel de procédure à distance (RPC) Open Source et indépendant du langage et de la plate-forme, initialement développé par Google. Vous pouvez en apprendre davantage à ce sujet à l'adresse grpc.io. Les API Cloud compatibles avec gRPC ont généralement à la fois des interfaces REST et RPC. Ainsi, plutôt que d'utiliser simplement JSON sur HTTP pour communiquer avec l'interface REST, les clients de l'API compatibles gRPC peuvent également utiliser Protocol Buffers 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 notre 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 nettement 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. Nous prévoyons de mettre à niveau vers gRPC le plus grand nombre possible de bibliothèques clientes Google Cloud. D'ici là, vous continuez de bénéficier de tous les autres avantages de notre code de bibliothèque cliente.

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 à la même fonctionnalité à l'aide des outils du SDK Google Cloud ou de la console Google Cloud Platform.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…