Registro de cambios

Este Changelog destaca los cambios notables en la Guía de diseño de la API.

2020-07

  • Se actualizó documentation.md para que coincida con https://google.aip.dev/192#formatting. Las tablas de Markdown y el código HTML sin procesar no deben usarse en los comentarios de proto.

  • Se introdujo ErrorInfo para el manejo de errores.

2020-04

  • Se cambió el nombre de las API de Cloud a las API de Google Cloud en el glosario.
  • Se introdujeron API y servicio como sinónimos del servicio de API.

2020-02

  • Se actualizó el control de versiones para agregar dos estrategias de control de versiones (basadas en canales y basadas en versiones), quitar orientación sobre las versiones de puntos y cambiar cómo nos referimos al control de versiones semántico.

2020-01

  • Agrega la retención de datos a los patrones de diseño.

2019-11

  • Agrega terminología de API de Cloud al glosario.
  • Se recomienda a los clientes que reintenten solo errores de UNAVAILBLE.

2019-06

  • Agrega "Bool vs. Enum vs. String" a los patrones de diseño.

2019-03

  • Agrega parámetros del sistema a los campos estándar.

2019-02

  • Agrega nombres con alcance de dominio para diseñar patrones.

03-2018

  • Agrega semántica de transmisión de cierre parcial a los patrones de diseño.

02-2018

  • Agrega read_time a los campos estándar.

01-2018

  • Agrega una referencia de esquema para la definición del servicio de API.

12-2017

  • Aclara que la versión principal de la API debe ser el último componente del nombre del paquete proto.

11-2017

  • Aclara por qué el método Create toma un recurso de entrada.
  • Aclara los ID de recopilación que no tienen forma plural, como análisis y caos.
  • Agrega el recurso de singleton a los patrones de diseño.
  • Aclara las convenciones de nombres C# para acrónimos y versiones.

09-2017

  • Agrega mime_type a los campos estándar.
  • Agrega expire_time a los campos estándar.
  • Agrega start_time y end_time a los campos estándar.

02-2017

  • Agrega “extremo de API” al glosario.
  • Agrega update_mask a los campos estándar.
  • Agrega un vínculo a FieldMask a los métodos estándar.
  • Menciona que la especificación de OpenAPI no admite números enteros sin signo.
  • Aclara que los nombres de los métodos deben usar verbos en modo imperativo.