aip-dev / google.aip.dev

API Improvement Proposals. https://aip.dev/
Other
1.08k stars 495 forks source link

feat(AIP-217): add brownfield adoption guidance #1385

Closed noahdietz closed 2 months ago

noahdietz commented 3 months ago

A new request field bool return_partial_success is recommended for brownfield list APIs that want to adopt the existing aspects of AIP-217. When set to true, the API will populate unreachable as AIP-217 dictates. This gives APIs a path towards aligning with AIP-217 behavior and gives users a compatible way of opting into a new behavior.

Internal bug for doc(s) and details: http://b/350763830