53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
|
# Introduction
|
||
|
|
`ABGroupAdd` is one of the SOAP actions the [Address Book Service](../abservice.md) provides.
|
||
|
|
|
||
|
|
Creates a contact group.
|
||
|
|
|
||
|
|
# Client/Request
|
||
|
|
The template used in this action is described on the [Address Book Service](../abservice.md) main page.
|
||
|
|
|
||
|
|
## ABGroupAdd
|
||
|
|
This element has only one attribute:
|
||
|
|
* `xmlns:` Is always set to `http://www.msn.com/webservices/AddressBook`.
|
||
|
|
|
||
|
|
### abId
|
||
|
|
This element contains your [Address Book Service](../abservice.md) GUID.
|
||
|
|
|
||
|
|
### groupAddOptions
|
||
|
|
This element has only one child:
|
||
|
|
* `<fRenameOnMsgrConflict>`: Should this group be renamed if it conflicts with
|
||
|
|
a group that already exists in the Messenger Service (`true` or `false`)?
|
||
|
|
|
||
|
|
### groupInfo
|
||
|
|
This element only contains the `<GroupInfo>` element.
|
||
|
|
|
||
|
|
#### GroupInfo
|
||
|
|
This element contains four children:
|
||
|
|
* `<name>`: The name of the group.
|
||
|
|
* `<groupType>`: The GUID type of group:
|
||
|
|
* `C8529CE2-6EAD-434d-881F-341E17DB3FF8`: A contact group.
|
||
|
|
* `<fMessenger>`: Unknown purpose (`true` or `false`).
|
||
|
|
|
||
|
|
##### annotations
|
||
|
|
This element only contains one or multiple `<Annotation>` element(s).
|
||
|
|
|
||
|
|
###### Annotation
|
||
|
|
This element only has two children:
|
||
|
|
* `<Name>`: The key of this annotation.
|
||
|
|
* `<Value>`: The value of this annotation.
|
||
|
|
|
||
|
|
Usually only used to set `MSN.IM.Display` to `1`.
|
||
|
|
|
||
|
|
# Server/Response
|
||
|
|
The template used in this action is described on the [Address Book Service](../abservice.md) main page.
|
||
|
|
|
||
|
|
## ABGroupAddResponse
|
||
|
|
This element has only one attribute:
|
||
|
|
* `xmlns:` Is always set to `http://www.msn.com/webservices/AddressBook`.
|
||
|
|
|
||
|
|
### ABGroupAddResult
|
||
|
|
This element only contains the `<guid>` element.
|
||
|
|
|
||
|
|
#### guid
|
||
|
|
This element only contains the GUID of the newly created group.
|