Les services d'API utilisent généralement des fichiers .proto pour définir la surface de l'API et les fichiers .yaml permettant de configurer ces services. Chaque service d'API doit avoir un répertoire d'API à l'intérieur d'un dépôt d'API. Le répertoire de l'API devrait
contenant tous les fichiers de définition d'API et les scripts de compilation.
Chaque répertoire d'API doit avoir la disposition standard suivante :
Répertoire d'API
Prérequis du dépôt
BUILD: le fichier de la versionMETADATA: le fichier des métadonnées de la versionOWNERS: les propriétaires du répertoire de l'APIREADME.md: les informations générales sur le service d'API
Fichiers de configuration
{service}.yaml: le fichier de configuration du service de référence, qui est la représentation YAML du message protogoogle.api.Serviceprod.yaml: le fichier de configuration du service delta de productionstaging.yaml: le fichier de configuration du service delta de préproductiontest.yaml: le fichier de configuration du service delta de testlocal.yaml: le fichier de configuration du service delta local
Fichiers de documentation
doc/*: les fichiers de documentation technique Ils devraient être au format Markdown
Définitions d'interface
v[0-9]*/*: chacun de ces répertoires contient une version majeure de l'API, principalement les fichiers proto et les scripts de compilation.{subapi}/v[0-9]*/*: chacun de ces répertoires{subapi}contient la définition d'interface d'une sous-API. Chaque sous-API peut posséder sa propre version majeure indépendante.type/*: les fichiers proto contenant des types partagés entre différentes API, différentes versions de la même API ou entre l'API et la mise en œuvre du service. Les définitions de type soustype/*ne devraient pas comporter de modifications destructives après leur publication.
Les définitions des API Google publiques sont publiées sur GitHub. Consultez le dépôt des API Google. Pour en savoir plus sur la structure des répertoires, consultez la page Exemple d'API de l'infrastructure de service.