University of Cambridge group API

Methods for querying and manipulating groups.#### The fetch parameter for groupsAll methods that return groups also accept an optional `fetch`parameter that may be used to request additional information about thegroups returned. For more details about the general rules that apply tothe `fetch` parameter, refer to the `PersonMethods`documentation.For groups the `fetch` parameter may be used to fetch referencesto people, institutions or other groups. In each case, only non-cancelledpeople, institutions and groups will be included when fetching references.The following references are supported:* `"all_members"` - fetches all the people who are members of the group, including members of groups included by the group, and groups included by those groups, and so on.* `"direct_members"` - fetches all the people who are direct members of the group, not taking into account any included groups.* `"members_of_inst"` - if the group is a membership group for an institution, this fetches that institution.* `"owning_insts"` - fetches all the institutions to which the group belongs.* `"manages_insts"` - fetches all the institutions that the group manages. Typically this only applies to "Editor" groups.* `"manages_groups"` - fetches all the groups that this group manages. Note that some groups are self-managed, so this may be a self-reference.* `"managed_by_groups"` - fetches all the groups that manage this group.* `"reads_groups"` - fetches all the groups that this group has privileged access to. This means that members of this group can see the members of the referenced groups regardless of the membership visibility settings.* `"read_by_groups"` - fetches all the groups that have privileged access to this group.* `"includes_groups"` - fetches all the groups included by this group.* `"included_by_groups"` - fetches all the groups that include this group.As with person `fetch` parameters, the references may be usedin a chain by using the "dot" notation to fetch additional informationabout referenced people, institutions or groups. For example`"all_members.email"` will fetch the email addresses of all membersof the group. For more information about what can be fetched fromreferenced people and institutions, refer to the documentation for`PersonMethods` and `InstitutionMethods`.