Description Andrew Flegg (reporter) 2010-06-27 16:33:38 UTC

BACKGROUND
~~~~~~~~~~
There are additional fields that you can pull from LinkedIn for your
connections:
  * phone-numbers
  * date-of-birth
  * twitter-accounts
  * main-address

LINKEDIN/API.PY
~~~~~~~~~~~~~~~
These should be suffixed, along with other fields, on to
package/src/org/maemo/hermes/engine/linkedin/api.py:LI_CONN_API_URL, in the
form:

   .../connections:(phone-numbers,date-of-birth)

This returns additional content under the <person> element:

    <date-of-birth>
      <year>1976</year>
      <month>4</month>
      <day>31</day>
    </date-of-birth>
    <main-address>123 Acacia Avenue, Exampleton</main-address>
    <phone-numbers total="1">
      <phone-number>
        <phone-type>home</phone-type>
        <phone-number>+44 123 456 789</phone-number>
      </phone-number>
    </phone-numbers>

Phone numbers are fairly arbitrary., however the default field list includes:

  location > country > code

This could be used for localised phone numbers to build up an international
format one. The complete selectors therefore should be:

connections:(id,first-name,last-name,picture-url,site-standard-profile-request:(url),date-of-birth,main-address,location:(country:(code)),phone-numbers,member-url-resources

FRIEND
~~~~~~
Address and phone numbers should be stored against the Friend object.

CONTACT
~~~~~~~
* add_phone_number(number, type = None, country = None)

Adds a phone number if the last six digits don't match an existing number. If
'number' doesn't start with '+', and 'country' is specified, an international
phone number will attempt to be built. The mapping from 2 character ISO-3166
country codes to phone number prefix can be built from http://countrycode.org/.
What further adjustments should be made to the number will be hardcoded
(references to a complete list of rules cannot be found). For example, if
'country' == 'gb', a leading zero is dropped.

* set_address(address)

Sets an address if the contact doesn't have one already set. Due to the
free-formattedness of this field, no reconciliation with existing fields will
be done.