API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
I really like the maxResults and pageToken pattern. https://developers.google.com/+/api/latest/activities/list