Versioning
The version is in the path. Withinv1 changes are additive only: new fields,
enumeration values, optional filters and endpoints. Anything else ships as
v2. Ignore unknown fields and treat unknown enumeration values as opaque.
Conventions shared by every endpoint.
v1 changes are additive only: new fields,
enumeration values, optional filters and endpoints. Anything else ships as
v2. Ignore unknown fields and treat unknown enumeration values as opaque.