v2024-08-07

Notable changes

• Overhaul of AIP-217:
  • New guidance for adopting AIP-217 in brownfield APIs (#1385)
  • Significant change to AIP-217 pagination guidance to align with existing horizontal capabilities & improve user experience (#1392)
  • Restructuring of and clarifications to existing AIP-217 guidance (#1393)
• Standard Update update_mask, going forward, must be OPTIONAL and default to payload-based patch semantics (#1327)
• Introduction of new google.api.field_behavior value IDENTIFIER (AIP-203)
• Introduction of new google.api.FieldInfo (proto) extension and AIP-202
• New guidance for server-modified values, service-specific default values, and field ownership (AIP-129)
• Singleton resources (AIP-156) may support Standard List via Reading Across Collections (AIP-159) (#1195)

Other changes

• fix(AIP-123): add order-preserving requirement for resource name patterns (#1398)
• fix(AIP-121): clarify acyclic parent-child relation (#1379)
• fix(AIP-123): clarify that resource type naming constraints
• fix(AIP-122): clarify shortening rules for nested collections (#1372)
• feat(AIP-191): add go_package guidance (#1371)
• fix(AIP-135): add parent deletion precondition behavior (#1370)
• fix(AIP-149): add backwards compatibility section (#1366)
• fix(AIP-158): clarify breaking change rules around pagination (#1358)
• fix(AIP-140): adding note about client side impact of fiel naming (#1355)
• feat(AIP-4236): API Versioning for Version-aware clients (#1331)
• feat(AIP-151): Add AIP-163 validation-only guidance for LROs (#1341)
• feat(AIP-193): Refactor with Actionable Errors guidance (#1305)
• fix(AIP-4231): add resource reference compatibility guidance (#1332)
• fix(AIP-156): require singular and plural in resource (#1328)
• fix(AIP-4235): update generator behavior for explicit field presence (#1325)
• feat(AIP-4235): automatically populate fields in the request message (#1307)
• fix(AIP-133): clarify user-specified ids only required on standard create (#1250)
• fix(AIP-203): explain IDENTIFIER behavior (#1241)
• feat(AIP-148): add well known strings section (#1239)
• fix(AIP-155): add format extension guidance (#1234)
• feat(AIP-129): new AIP for server modified values (#1144)
• feat(AIP-202): add enriched Field descriptor AIP (#1216)
• feat(AIP-203): clarify fb in nested messages (#1182)
• feat(AIP-121): adding guidance around consistency (#1060)
• feat(AIP-122): disallow embedding resources in resources (#1196)
• fix(AIP-192): Expand deprecated comment requirement to all components (#1198)

v2023-08-07

Notable Changes:

• Add terminology for Declarative clients (#1186)
• fix(AIP-156): Do not define Update on singletons with only output only fields. (#1188)
• fix(AIP-121): clarify stateless protocol definition (#1184)
• feat(AIP-203): document field behavior compatibility (#1172)
• AIP-180: Clarify scope of compatibility rules. (#1187)
• feat(AIP-4210): add code gen diagram + tweaks (#1148)
• fix(AIP-134): consolidate AIP-161 mask guidance (#1173)
• fix(AIP-164): clarify 164 is declarative-unfriendly (#1171)
• feat(AIP-8): clarify clients AIPs should benefit (#1114)
• fix(AIP-149): differentiate field presence and behavior (#1143)
• feat(AIP-148): introduce purge_time (#1169)
• feat(AIP-4222): define path_template syntax (#1067)
• List common packages that are org-specific or non-conformant (#1157)
• fix(AIP-122): remove redundant guidance on user-settable (#1139)
• feat: Restructure AIPs 213 and 215, with more common proto details (#1117)
• feat(AIP-111): introducing AIP around planes. (#1132)
• feat(AIP-180): describe default breaking changes (#1076)
• feat(AIP-9): adding client term (#1113)
• feat(AIP-203): clarify immutable optional, required fields (#1120)

v2023-05-26

Notable changes:

• AIP-133: Resources should support user-settable IDs #1019 (note: #1121 raises that requirements may be lowered for data-plane resources).
• AIP-136: Prohibit the term "async" in custom methods: #1105
• AIP-136: use parent instead of the resource singular when referring to the resource #1093
• AIP-193: require unique error detail messages #1087
• AIP-203: require field behavior annotation for request messages #1100
• AIP-233: loosen recommendations around partial successes #1071

Initial version of AIPs

As aligned with https://google.aip.dev/3, This is the first versioned release of the AIPs.

No major changes have occurred recently, but this version acts as a reference point for future changes.