Cloud de Confiance by S3NS Les API sont des interfaces programmatiques qui vous permettent d'intégrer des services de calcul, de mise en réseau, de stockage et de machine learning dans vos applications. Vous pouvez appeler ces API réseau via des points de terminaison JSON HTTP ou gRPC, généralement à l'aide d'outils tels que des bibliothèques clientes ou la Google Cloud CLI.
À propos des API Cloud
Les API Cloud, telles que l'API Cloud Pub/Sub, sont exposées en tant que services d'API réseau aux clients. Chaque API Cloud s'exécute généralement sur un ou plusieurs sous-domaines de googleapis.com, tels que pubsub.googleapis.com, et fournit aux clients des interfaces JSON HTTP et gRPC via les réseaux Internet public et cloud privé virtuel (VPC). Les clients peuvent envoyer des requêtes HTTP et gRPC directement aux points de terminaison de l'API Cloud ou à l'aide de bibliothèques clientes.
APIs Cloud font partie de la catégorie des Google Enterprise API dans la Cloud de Confiance console bibliothèque d'API.
Il existe deux types d' Cloud de Confiance API :
API basées sur des ressources, qui utilisent le projet associé aux ressources accessibles pour la facturation et les quotas.
API basées sur un client, qui utilisent le projet associé au client qui accède aux ressources pour la facturation et les quotas.
Accéder aux API Cloud
Vous pouvez accéder APIs Cloud à partir d'applications serveur avec nos bibliothèques clientes dans de nombreux langages de programmation courants, à partir d'applications mobiles via les SDK Firebase, ou à l'aide de clients tiers. Vous pouvez également accéder APIs Cloud avec la gcloud CLI, Cloud de Confiance console, ou les serveurs Google Cloud MCP.
Si vous débutez avec les APIs Cloud, consultez la page Premiers pas.
Compatibilité avec HTTP et gRPC
Toutes les API Cloud fournissent une interface HTTP JSON simple que vous pouvez appeler directement ou via les bibliothèques clientes des API Google. La plupart des API Cloud fournissent également une gRPC gRPC que vous pouvez appeler via les bibliothèques clientes Google Cloud, qui offrent de meilleures performances et une meilleure convivialité. Vous pouvez également utiliser des clients tiers.
Pour en savoir plus sur nos bibliothèques clientes, consultez la page Présentation des bibliothèques clientes.
Pour en savoir plus sur l'authentification lors de l'utilisation des API Google, consultez Méthodes d'authentification chez Google et Authentification lors de l'utilisation de bibliothèques clientes.
Chiffrement TLS
Toutes les API Cloud acceptent uniquement les requêtes sécurisées utilisant le chiffrement TLS.
- Si vous utilisez l'une de nos bibliothèques clientes, le chiffrement en transit est géré pour vous par la bibliothèque.
- Si vous utilisez votre propre client gRPC, vous devez vous authentifier auprès de Google (qui nécessite TLS) en suivant les instructions du guide d'authentification gRPC.
- Si vous créez votre propre client HTTP, consultez nos consignes sur HTTP.
Pour en savoir plus sur la sécurisation du trafic vers les Cloud de Confiance by S3NS services, consultez notre guide de sécurité Chiffrement en transit.
Private Service Connect
Les entreprises souhaitent souvent accéder aux API Cloud en mode privé pour des raisons de sécurité et de conformité. Vous pouvez utiliser Private Service Connect pour configurer et gérer ce type d'accès au sein de vos réseaux VPC.
Pour plus d'informations, consultez la page Configurer Private Service Connect.
Exemples détaillés
Consultez les guides détaillés suivants qui utilisent les bibliothèques clientes pour certaines API courantes :
- API Cloud Billing Budget avec Node.js.
- API Cloud Billing Budget avec Python.
- Cloud Logging avec Node.js.
- Cloud Logging avec Python.
- Cloud Logging avec Go
- Cloud Logging avec Java.
- Speech-to-Text avec Node.js.
- Speech-to-Text avec Python.
- Speech-to-Text avec Go.
- Speech-to-Text avec Java.
Guide de conception d'API
Quel que soit le type d'interface, toutes les API Cloud utilisent les principes de conception orientés ressources décrits dans notre guide de conception des API, qui garantissent une expérience de développement simple et cohérente. Pour mieux comprendre les API Cloud, consultez notre guide de conception d'API.
Si vous souhaitez étudier la définition de l'interface des APIs Cloud, vous pouvez consulter le dépôt des API Google sur GitHub.
Limiter votre utilisation
Les API Cloud sont partagées parmi des millions de développeurs et d'utilisateurs. Pour garantir une utilisation équitable et minimiser les risques d'abus, toutes les API Cloud appliquent des limites de débit et des quotas de ressources en fonction de l'utilisation, communément appelés quotas. Vous pouvez également utiliser ces quotas pour contrôler vos dépenses liées aux produits Google Cloud en réduisant vos propres limites de quota. Si vous avez besoin de plus de quotas que les limites par défaut, vous devez envoyer des demandes d'augmentation du quota.
Pour en savoir plus, consultez la section Limiter l'utilisation des API.
Surveiller votre utilisation
La plupart des API Cloud fournissent des informations détaillées sur leur utilisation dans votre projet, y compris les niveaux de trafic, les taux d'erreur et les latences. Cela vous permet de trier rapidement les problèmes liés aux applications qui utilisent les APIs Cloud. Vous pouvez afficher ces informations dans le Google Cloud tableau de bord des API de la Cloud de Confiance console. Vous pouvez également créer des tableaux de bord et des alertes personnalisés dans Cloud Monitoring.
Pour en savoir plus, consultez la section Surveiller l'utilisation des API.
API Google Enterprise
Les API Google Enterprise sont des API à haute stabilité prêtes pour une utilisation de niveau entreprise avec des options d'assistance disponibles.
Pour en savoir plus, consultez la page API Google Enterprise.