AddressBookGroupListEntry

Schema used to return contacts that belong to a specific group.

The 'UserID' and 'Password' elements identify the account. The 'ServiceName' element must be set to 'AddressBookGroupListEntry'. The 'SoftwareVersion' element is for internal 2SMS use only and should not be set.

The 'ServiceDetail' must contain one of the following child elements:

A 'GroupID' element with the 'GroupID' of the group to be listed. The user must have 'high' or 'medium' access to the group (see method code 0140).
A 'GroupName' element with the 'GroupName' of the group to be listed. The user must have 'high' or 'medium' access to the group.

This method returns a succesful "00/OK" response if a list of contacts from the requested group was obtained. The 'Result' element confirms this and reports the number of entries returned, and how many are from the user's own address book.

The 'Detail' element contains a set of 'Record' children, each of which provides information on a group member:

'PersonNumber' is the value used by 2SMS to uniquely identify the contact. Address book entries are added and removed from a group using this value (see method codes 0170 and 0180).
The 'ownEntry' attribute of 'PersonNumber' is set to 'true' if the entry was taken from the user's own address book.
'FirstName' contains the first-name of the contact.
'LastName' contains the last-name of the contact.
'MobilePhone' contains the mobile phone number of the contact (may be empty).
'EmailAddress' contains the email address of the contact (may be empty).

The 'Detail' element also contains an 'Entries' element with a 'total' attribute that reports the total number of group members and an 'own' attribute that reports how many of these were taken from the user's own address book.