Practical API Design at Netflix, Part 1: Using Protobuf FieldMask
Never rename fields when FieldMask is used. If a field is renamed, the backend should be able to support new and old field names until all the callers migrate to the new field name (backward compatibility issue) Deprecate a field and create a new field instead of renaming.