Changelog

Ce journal des modifications présente les modifications significatives apportées au guide de conception d'API.

2002-04

  • Remplacement du terme "API Google Cloud" par "API Cloud" dans le glossaire.
  • Définition des termes "API" et "service" comme synonymes de "service d'API".

2020-02

  • Mise à jour des informations sur la gestion des versions pour ajouter deux stratégies (la gestion des versions stables et la gestion des versions déployées). Suppression des indications sur les versions ponctuelles et modification de la définition de ce que l'on appelle "gestion sémantique des versions".

2020-01

  • Ajout de la fonctionnalité de conservation des données aux modèles de conception.

2019-11

  • Ajout du terme API Cloud au glossaire.
  • Recommandation aux clients de ne renouveler les tentatives qu'en cas d'erreur de type "UNAVAILBLE".

2019-06

  • Ajout de la section "Champs de type Bool, Enum et String" aux modèles de conception.

Mars 2019

  • Ajout de paramètres système aux champs standards

Février 2019

  • Ajout de noms à l'échelle du domaine aux schémas de conception

Mars 2018

  • Ajout d'une sémantique de fermeture partielle en streaming aux modèles de conception.

Février 2018

  • Ajout de read_time aux champs standards.

Janvier 2018

  • Ajout d'une référence de schéma pour la définition de service de l'API.

Décembre 2017

  • Clarification selon laquelle la version majeure de l'API doit être le dernier composant du nom du package proto.

Novembre 2017

  • Clarification de la raison pour laquelle la méthode Create utilise une ressource d'entrée.
  • Clarification de la raison pour laquelle les ID de collection n'ont pas de forme au pluriel, tels que "temps et "météo".
  • Ajout d'une ressource unique aux modèles de conception.
  • Clarification des conventions d'attribution de noms en C# pour les acronymes et les versions.

Septembre 2017

  • Ajout de mime_type aux champs standards.
  • Ajout de expire_time aux champs standards.
  • Ajout de start_time et end_time aux champs standards.

Février 2017

  • Ajout de "Point de terminaison de l'API" au glossaire.
  • Ajout de update_mask aux champs standards.
  • Ajout d'un lien vers FieldMask aux méthodes standards.
  • Mention indiquant que la spécification OpenAPI n'est pas compatible avec les entiers non signés.
  • Clarification précisant que les noms de méthode doivent utiliser des verbes à l’impératif.