groups.md

Groups

Groups are sets of users that can be used in collaborations.

• Get All Groups
• Create a Group
• Update a Group
• Delete a Group
• Get a Groups collaborations
• Create Membership
• Get Membership
• Update Membership
• Delete Membership
• Get Memberships for Group
• Get Memberships for User

Get All Groups

Calling the static getAllGroups(BoxAPIConnection) will return an iterable that will page through all of the user's groups.

Iterable<BoxGroup.Info> groups = BoxGroup.getAllGroups(BoxAPIConnection api);
for (BoxGroup.Info groupInfo : groups) {
    // Do something with the group.
}

Create a Group

The static createGroup(BoxAPIConnection, String) method will let you create a new group with a specified name.

BoxGroup.Info groupInfo = BoxGroup.createGroup(api, "My Group");

Update a Group

To update a group, call updateInfo(BoxGroup.Info) method.

BoxGroup group = new BoxGroup(api, id);
BoxGroup.Info groupInfo = group.getInfo();
groupInfo.addPendingChange("name", "New name for My Group");
group.updateInfo(groupInfo);

Delete a Group

A group can be deleted by calling the delete() method.

BoxGroup group = new BoxGroup(api, "id");
group.delete();

Get a Groups collaborations

A groups collaborations can be retrieved by calling the getCollaborations() method.

BoxGroup group = new BoxGroup(api, "id");
group.getCollaborations();

Create Membership

Membership for the group can be created by calling addMembership(BoxUser) and addMembership(BoxUser, Role) methods.

BoxGroup group = new BoxGroup(api, "groupID");
BoxUser user = new BoxUser(api, "userID");
BoxGroupMembership.Info groupMembershipInfo = group.addMembership(user);

Get Membership

A groups membership can be retrieved by calling the BoxGroupMembership.getInfo() method.

BoxGroupMembership membership = new BoxGroupMembership(api, id);
BoxGroupMembership.Info groupMembershipInfo = membership.getInfo();

Update Membership

A groups membership can be updated by calling the BoxGroupMembership.updateInfo(BoxGroupMembership.Info) method.

BoxGroupMembership membership = new BoxGroupMembership(api, id);
BoxGroupMembership.Info info = membership.new Info();
info.addPendingChange("role", role);
membership.updateInfo(info);

Delete Membership

A group can be deleted by calling the BoxGroupMembership.delete() method.

BoxGroupMembership membership = new BoxGroupMembership(api, id);
membership.delete();

Get Memberships for Group

Calling the getAllMemberships(String...) will return an iterable that will page through all of the group's memberships. Optional parameters can be used to retrieve specific fields of the Group Membership object.

BoxGroup group = new BoxGroup(api, id);
Iterable<BoxGroupMembership.Info> memberships = group.getAllMemberships();
for (BoxGroupMembership.Info membershipInfo : memberships) {
    // Do something with the membership.
}

Get Memberships for User

Calling the BoxUser.getAllMemberships(String...) will return an iterable that will page through all of the user's memberships. Optional parameters can be used to retrieve specific fields of the Group Membership object.

BoxUser user = new BoxUser(api, id);
Iterable<BoxGroupMembership.Info> memberships = user.getAllMemberships();
for (BoxGroupMembership.Info membershipInfo : memberships) {
    // Do something with the membership.
}