Glossaire

API réseau

  • 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 Google

  • 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 Google Cloud Console 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.

API Google Cloud

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

Interface API

  • 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 de l'API

  • 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.

Méthode API

  • 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.

Requête API

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

Service d'API

  • 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.

Titre de l'API

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

Nom de service de l'API

  • 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".

Point de terminaison de service d'API

  • 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.

Définition du service d'API

  • 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.

Produit d'API

  • 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.

Utilisateur de l'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.

Producteur d'API

  • 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.

Backend de l'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.

Frontend 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.