110 lines
5.0 KiB
Markdown
110 lines
5.0 KiB
Markdown
|
# Introduction
|
||
|
|
The `<contactInfo>` element is the main associative element of a `<Contact>` node.
|
||
|
|
|
||
|
|
# contactInfo
|
||
|
|
This element can contain many children, all of which optional:
|
||
|
|
* `<quickName>`: The sorting name of this contact
|
||
|
|
* `<passportName>`: The user handle of this contact.
|
||
|
|
* `<IsPassportNameHidden>` Are the contents of `<passportName>` hidden to the user (`true` or `false`)?
|
||
|
|
* `<isMessengerUser>`: Is this contact a part of the Messenger Service Network (`true` or `false`)?
|
||
|
|
* `<contactType>`: The type of contact this is related to:
|
||
|
|
* `LivePending`: A user yet to authorise you
|
||
|
|
* `Regular`: A user from another service.
|
||
|
|
* `<displayName>`: The display name for this contact.
|
||
|
|
* `<puid>`: Unused. Always 0.
|
||
|
|
* `<CID>`: The Common ID of this contact, which is a signed 64-bit integer.
|
||
|
|
* `<IsNotMobileVisible>`: Is this contact not visible as a mobile user (`true` or `false`)?
|
||
|
|
* `<isMobileIMEnabled>`: Does this contact allow me to talk to them via their mobile device (`true` or `false`)?
|
||
|
|
* `<isFavorite>`: Is this contact in the "Favorites" group (`true` or `false`)?
|
||
|
|
* `<isSmtp>`: Is this contact using a Japanese mobile phone (`true` or `false`)?
|
||
|
|
* `<hasSpace>`: Does this contact have a blog (`true` or `false`)?
|
||
|
|
* `<spotWatchState>`: Does this contact have a web watch, if not, set to `NoDevice`.
|
||
|
|
* `<birthdate>`: This contact's birthday as a ISO 8601 timestamp.
|
||
|
|
* `<PendingAnnotations>`: ([`ABContactAdd`](abcontactadd.md) only)
|
||
|
|
A list of [`<Annotation>`](#annotation) elements you would like to add.
|
||
|
|
* `<firstName>`: The first name for this contact.
|
||
|
|
* `<lastName>`: The last name for this contact.
|
||
|
|
* `<comment>`: The user attached comment for this contact. New lines are included as-is.
|
||
|
|
* `<MiddleName>`: The middle name for this contact.
|
||
|
|
* `<annotations>`: Contains many [`<Annotation>`](#annotation) elements.
|
||
|
|
* `<primaryEmailType>`: Can be any of the following:
|
||
|
|
* `ContactEmailPersonal`
|
||
|
|
* `ContactEmailMessenger`
|
||
|
|
* `ContactEmailBusiness`
|
||
|
|
* `ContactEmailOther`
|
||
|
|
* `Passport`
|
||
|
|
* `<emails>`: Contains many [`<ContactEmail>`](#contactemail) elements.
|
||
|
|
* `<PrimaryPhone>`: Can be any of the following:
|
||
|
|
* `ContactPhonePersonal`
|
||
|
|
* `ContactPhonePager`
|
||
|
|
* `ContactPhoneFax`
|
||
|
|
* `ContactPhoneBusiness`
|
||
|
|
* `ContactPhoneOther`
|
||
|
|
* `ContactPhoneMobile`
|
||
|
|
* `<phones>`: Contains many [`<ContactPhone>`](#contactphone) elements.
|
||
|
|
* `<PrimaryLocation>`: Can be any of the following:
|
||
|
|
* `ContactLocationBusiness`
|
||
|
|
* `ContactLocationPersonal`
|
||
|
|
* `<locations>`: Contains many [`<ContactLocation>`](#contactlocation) elements.
|
||
|
|
* `<webSites>`: Contains many [`<ContactWebSite>`](#contactwebsite) elements.
|
||
|
|
* `<IsPrivate>`: Is this contact private (`true` or `false`).
|
||
|
|
* `<Gender>`: What gender is this contact, if unsure, set to `Unspecified`.
|
||
|
|
* `<TimeZone>`: What time zone is this contact in?, if unsure, set to `None`.
|
||
|
|
|
||
|
|
## Annotation
|
||
|
|
This element contains two children:
|
||
|
|
* `<Name>`: The key of this property:
|
||
|
|
* `MSN.IM.MBEA`: (Only for you) Can users talk to me via my mobile phone? (`0` or `1`).
|
||
|
|
* `MSN.IM.GTC`: (Only for you) Do I automatically add users to the AL or ask first? (`0` or `1`).
|
||
|
|
* `MSN.IM.BLP`: (Only for you) Are all users blocked or allowed by default to talk to me? (`0` or `1`).
|
||
|
|
* `AB.JobTitle`: The job title of this contact.
|
||
|
|
* `AB.NickName`: The user-provided nick-name for this contact.
|
||
|
|
* `AB.Spouse`: The contact's spouse's name.
|
||
|
|
* `<Value>`: The value of this property.
|
||
|
|
|
||
|
|
## ContactEmail
|
||
|
|
This element contains two children:
|
||
|
|
* `<contactEmailType>`: Can be any of the following:
|
||
|
|
* `ContactEmailPersonal`
|
||
|
|
* `ContactEmailMessenger`
|
||
|
|
* `ContactEmailBusiness`
|
||
|
|
* `ContactEmailOther`
|
||
|
|
* `<email>`: The e-mail address associated with the `<contactEmailType>`.
|
||
|
|
|
||
|
|
## ContactPhone
|
||
|
|
This element contains two children:
|
||
|
|
* `<contactPhoneType>`: Can be any of the following:
|
||
|
|
* `ContactPhonePersonal`
|
||
|
|
* `ContactPhonePager`
|
||
|
|
* `ContactPhoneFax`
|
||
|
|
* `ContactPhoneBusiness`
|
||
|
|
* `ContactPhoneOther`
|
||
|
|
* `ContactPhoneMobile`
|
||
|
|
* `<number>`: The phone number associated with the `<contactPhoneType>`.
|
||
|
|
|
||
|
|
## ContactLocation
|
||
|
|
This element contains two children:
|
||
|
|
* `<contactLocationType>`: Can be any of the following:
|
||
|
|
* `ContactLocationBusiness`
|
||
|
|
* `ContactLocationPersonal`
|
||
|
|
* `<name>`: The name associated with the `<contactLocationType>`.
|
||
|
|
* `<street>`: The street associated with the `<contactLocationType>`.
|
||
|
|
* `<city>`: The city associated with the `<contactLocationType>`.
|
||
|
|
* `<state>`: The state associated with the `<contactLocationType>`.
|
||
|
|
* `<country>`: The country associated with the `<contactLocationType>`.
|
||
|
|
* `<postalCode>`: The postal code associated associated with the `<contactLocationType>`.
|
||
|
|
* `<Changes>`: A space delimited list of changed elements in this `<ContactLocation>`:
|
||
|
|
* `Name`
|
||
|
|
* `Street`
|
||
|
|
* `City`
|
||
|
|
* `State`
|
||
|
|
* `Country`
|
||
|
|
* `PostalCode`
|
||
|
|
|
||
|
|
## ContactWebSite
|
||
|
|
This element contains two children:
|
||
|
|
* `<contactWebSiteType>`: Can be any of the following:
|
||
|
|
* `ContactWebSiteBusiness`
|
||
|
|
* `ContactWebSitePersonal`
|
||
|
|
* `<webURL>`: The location of the website associated with the `<contactWebSiteType>`.
|