Glossaire

Interfaces de programmation d'applications (API) fonctionnant sur un réseau d'ordinateurs. Elles communiquent à l'aide de protocoles réseau, y compris HTTP et gRPC, et sont souvent produites par des organisations différentes de celles qui les utilisent.

API réseau exposées par les services Google. La plupart d'entre elles sont hébergées sur le domaine googleapis.com. Vous pouvez découvrir les API Google disponibles à l'aide de la console Google Cloud et de l'API Service Usage. Ce terme n'inclut pas les autres types d'API, tels que les bibliothèques clientes et les SDK.

Remarque : Toutes les API Google partagent un modèle d'utilisation commun. Un utilisateur d'API consomme un service d'API géré par un producteur d'API. Les développeurs et les utilisateurs bénéficient ainsi d'une expérience simple et cohérente dans toutes les API Google.

Sous-ensemble des API Google exposées par les services Google Cloud. Pour en savoir plus, consultez la page API Google Cloud.

Définition d'un protocole Protocol Buffers service. Elle est généralement mappée vers une interface dans la plupart des langages de programmation. Une interface API peut être mise en œuvre par autant de services d'API que vous le souhaitez.

Version d'une interface API ou d'un groupe d'interfaces API, si elles sont définies ensemble. Une version d'API est souvent représentée par une chaîne, telle que "v1", et présente dans les demandes d'API et les noms de package de Protocol Buffers.

Opération individuelle dans une interface API. Elle est représentée dans Protocol Buffers par une définition rpc et est généralement mappée vers une fonction dans une interface dans la plupart des langages de programmation.

Appel unique de méthode API. Il est souvent utilisé comme unité de facturation, de journalisation, de surveillance et de limitation du débit.

Mise en œuvre déployée d'une ou de plusieurs interfaces d'API, exposées sur une ou plusieurs adresses réseau, telles que l'API Cloud Pub/Sub.

Remarque :API et API sont des termes couramment utilisés pour désigner l'ingénierie logicielle. Ils signifient des choses très différentes selon les contextes. Nous vous recommandons vivement de ne pas définir leur signification. Pour les API Google, API et service sont des raccourcis des services d'API fournis par Google, répertoriés dans la console Google Cloud sous Bibliothèque d'API.

Fait référence au titre du produit destiné aux utilisateurs d'un service d'API, tel que "API Cloud Pub/Sub".

Fait référence à l'identifiant logique d'un service d'API. Les API Google utilisent des noms compatibles RFC 1035 DNS comme noms de service d'API, tels que "pubsub.googleapis.com".

Fait référence à une adresse réseau utilisée par un service d'API pour traiter les requêtes API. Exemples : https://pubsub.googleapis.com, https://content-pubsub.googleapis.com. Un service unique peut avoir plusieurs points de terminaison.

Combinaison de définitions d'interface API (fichiers .proto) et des configurations de service API (fichiers .yaml) utilisées pour définir un service API. Le schéma de la définition de service d'API Google est google.api.Service.

Service d'API et composants connexes, tels que les conditions d'utilisation, la documentation, les bibliothèques clientes et l'assistance du service. Ces services sont présentés collectivement aux clients en tant que produit. Par exemple, l'API Google Agenda. On parle parfois d'un produit d'API simplement comme d'une API.

Entité qui utilise un service d'API. Pour les API Google, il s'agit généralement d'un projet Google détenant l'application cliente ou la ressource serveur.

Entité qui produit un service d'API. Pour les API Google, il s'agit généralement d'un projet Google détenant le service d'API.

Ensemble de serveurs et infrastructure associée qui met en œuvre la logique métier pour un service d'API. Un serveur backend d’API unique est souvent appelé serveur d’API.

Ensemble de serveurs et infrastructure associée fournissant des fonctionnalités communes à tous les services d'API, telles que l'équilibrage de charge et l'authentification. Un serveur frontend d'API unique est souvent appelé un proxy d'API.

Notez que les frontend et backend d'API peuvent s'exécuter côte à côte ou très loin l'un de l'autre. Dans certains cas, ils peuvent être compilés dans un fichier binaire d'application unique et exécutés dans un même processus.