Changelog

This Changelog highlights notable changes to the API Design Guide.

2020-01

• Add data retention to design patterns.

2019-11

• Add terminology Cloud APIs to glossary.
• Recommend clients to retry only for UNAVAILBLE errors.

2019-06

• Add "Bool vs Enum vs String" to design patterns.

2019-03

• Add system parameters to standard fields.

2019-02

• Add domain-scoped names to design patterns.

2018-03

• Add streaming half-close semantics to design patterns.

2018-02

• Add read_time to Standard Fields.

2018-01

• Add schema reference for API Service Definition.

2017-12

• Clarify API major version must be the last component of proto package name.

2017-11

• Clarify why the Create method take an input resource.
• Clarify collection IDs that don't have plural form, such as evidence and weather.
• Add singleton resource to design patterns.
• Clarify C# naming conventions for acronyms and versions.

2017-09

• Add mime_type to standard fields.
• Add expire_time to standard fields.
• Add start_time and end_time to standard fields.

2017-02

• Add "API endpoint" to glossary.
• Add update_mask to standard fields.
• Add a link to FieldMask to standard methods.
• Mention that OpenAPI spec does not support unsigned integers.
• Clarify that method names should use verbs in the imperative mood.