adopt [simple JSON notation](https://github.com/mpnally/Terrifically-Simple-JSON) and [use links instead of IDs](https://cloud.google.com/blog/products/application-development/api-design-why-you-should-use-links-not-keys-to-represent-relationships-in-apis)
