This came out of support threads where the same question kept arriving in slightly different shapes.
The change is backwards compatible. Older SDK versions continue to function; upgrading unlocks the new fields without any code change beyond the bump.