Releases: aip-dev/google.aip.dev
Releases ยท aip-dev/google.aip.dev
v2024-08-07
Notable changes
- Overhaul of AIP-217:
- Standard Update
update_mask
, going forward, must beOPTIONAL
and default to payload-based patch semantics (#1327) - Introduction of new
google.api.field_behavior
valueIDENTIFIER
(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.