Groups.getMembers (Method)

Returns zero or more structures, each containing information about a group's members. These members are users or other groups.

Returns:

Groups_GetMembers_Result (query)

Each row of the returned query results has the following fields:

Field Name Type Description
Description PlainText If the 'Type' member is 'User', this member contains the user's full Name (FirstName LastName). If 'Type' is 'Group', this member contains the group's description.
EmailAddress EmailAddress The email address of the user, empty string if a group.
FirstName PlainText If the 'Type' member is 'User', this member contains the user's first name. If 'Type' is 'Group', this member contains an empty string.
GroupType GroupType_EmptyString Normal or Visitor Context for groups, or empty string for users.
ID UserGroupIDorOrphan The ID of the user or group that is a member of this group.
LastName PlainText If the 'Type' member is 'User', this member contains the user's last name. If 'Type' is 'Group', this member contains an empty string.
MiddleName PlainText If the 'Type' member is 'User', this member contains the user's middle name or empty string if there is no middle name. If 'Type' is 'Group', this member contains an empty string.
Name PlainText_NonNull The member's name. The 'Type' member is 'User', this member contains the user ID (ssmith). If 'Type' is 'Group', this member contains the group's name.
Type UserGroupType A string indicating if this group member is a user or a group.

Arguments:

Name Type Required Description
groupIDList GroupIDList_2 Required Comma delimited list of group's IDs other than 0 (Anonymous) or 1 (Authenticated Users).
type UsersGroupsExtendedFilter Optional. Defaults to 'All'. A string indicating the types of records to return; for example, 'Users', 'Groups', 'RecurseUsers', 'RecurseGroups' or 'All'. 'RecurseUsers' tells CommonSpot that it should only return information for users contained in the specified group and any child groups. 'RecurseGroups' tells CommonSpot that it should only return information for a group contained within the specified groups and any of its child groups.
searchField UserGroupSearchField Optional. Defaults to 'LastName'. Names the kind of members for which CommonSpot searches; for example, GroupDescription, GroupName, UserFirstName, and UserLastName.
searchOperator SearchOperator_EmptyString Optional. Defaults to an empty string. A search operator or an empty string. Values for this argument can be 'Begins With', 'Contains', 'Ends With', or 'Equals'.
searchString PlainText Optional. Defaults to an empty string. The value for which CommonSpot searches.
excludeList UserGroupIDList_EmptyString Optional. Defaults to an empty string. A comma-delimited list of one or IDs of the groups that CommonSpot excludes from the search. An empty string tells CommonSpot that it should not exclude any groups.

Context:

License Requirements None
Permission Requirements Contributor
Deny Context None
Require Context None
Author Lock (not required)
Transaction Logging Transaction logging is disabled for this method
Customization Customization is not supported for this method.

Error Codes:

Code Error Message
24000  
40012 If you specify a search string, you must also specify a search operator.

Notes:

None