845763 - [Contacts] Define a connector to import contacts from Gmail

Status: RESOLVED FIXED

(Firefox OS Graveyard :: Gaia::Contacts, defect)

Description

[Francisco Jordano [:arcturus] [:francisco]]

Create a connector based on the new infrastructure to import contacts from different sources.

In this case we will need to map the data coming from Gmail to our contacts database.

Comment 1

[Francisco Jordano [:arcturus] [:francisco]]

Marking as leo? as this will be needed in v1.1

Comment 2

[Francisco Jordano [:arcturus] [:francisco]]

We will be using Google Contacts API V3:

https://developers.google.com/google-apps/contacts/v3

Also using OAuth 2.0 for authenticating.

The contacts structure for each entry in google contacts is defined here:

https://developers.google.com/google-apps/contacts/v3/#contact_entry

With additional info regading the name (given, family, middle ...):
https://developers.google.com/gdata/docs/2.0/elements#gdName

And address (postal, city, country ...):
https://developers.google.com/gdata/docs/2.0/elements#gdStructuredPostalAddress

Comment 3

[Francisco Jordano [:arcturus] [:francisco]]

This is the response for a single contact (yes, it's in xml):

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:gContact="http://schemas.google.com/contact/2008" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="&quot;RXg9fDVSLit7I2A9WhBSGUsPQgU.&quot;">
    <id>http://www.google.com/m8/feeds/contacts/mepartoconmigo%40gmail.com/base/2fc27a388c2bd974</id>
    <updated>2013-02-27T11:45:14.664Z</updated>
    <app:edited xmlns:app="http://www.w3.org/2007/app">2013-02-27T11:45:14.664Z</app:edited>
    <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact" />
    <title>My Shiny Contact</title>
    <content>This is a Note</content>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/mepartoconmigo%40gmail.com/2fc27a388c2bd974" gd:etag="&quot;LhMgGHAHWit7I2BuPF4FFCt_B0ZEGiYpXwg.&quot;" />
    <link rel="self" type="application/atom+xml" href="https://www.google.com/m8/feeds/contacts/mepartoconmigo%40gmail.com/full/2fc27a388c2bd974" />
    <link rel="edit" type="application/atom+xml" href="https://www.google.com/m8/feeds/contacts/mepartoconmigo%40gmail.com/full/2fc27a388c2bd974" />
    <gd:name>
        <gd:fullName>My Shiny Contact</gd:fullName>
        <gd:givenName>My</gd:givenName>
        <gd:additionalName>Shiny</gd:additionalName>
        <gd:familyName>Contact</gd:familyName>
    </gd:name>
    <gContact:birthday when="1990-01-01" />
    <gd:organization rel="http://schemas.google.com/g/2005#other">
        <gd:orgName>The Company</gd:orgName>
        <gd:orgTitle>Title in Company</gd:orgTitle>
    </gd:organization>
    <gd:email rel="http://schemas.google.com/g/2005#home" address="[e-mail]" primary="true" />
    <gd:email rel="http://schemas.google.com/g/2005#work" address="[e-mail]" />
    <gd:im address="instantmessaging" protocol="http://schemas.google.com/g/2005#GOOGLE_TALK" rel="http://schemas.google.com/g/2005#other" />
    <gd:phoneNumber rel="http://schemas.google.com/g/2005#work">+1555111333444222</gd:phoneNumber>
    <gd:structuredPostalAddress rel="http://schemas.google.com/g/2005#home">
        <gd:formattedAddress>This is the Street
The PO Box
The Nieghborhood, The City, The State The Zip
The Country</gd:formattedAddress>
        <gd:street>This is the Street</gd:street>
        <gd:neighborhood>The Nieghborhood</gd:neighborhood>
        <gd:pobox>The PO Box</gd:pobox>
        <gd:postcode>The Zip</gd:postcode>
        <gd:city>The City</gd:city>
        <gd:region>The State</gd:region>
        <gd:country>The Country</gd:country>
    </gd:structuredPostalAddress>
    <gContact:website href="http://www.myurl.com" rel="profile" />
    <gContact:groupMembershipInfo deleted="false" href="http://www.google.com/m8/feeds/groups/mepartoconmigo%40gmail.com/base/6" />
</entry>

From this data we will map to our contact object:
name -> title
honorificPrefix -> gd:name prefix (if present)
givenName -> gd:name givenName
additionalName -> gd:name additionalName
familyName -> gd:name familyName
honorificSuffix -> gd:name suffix (if present)
nickname -> cannot find a match
email -> gd:email address
photo -> link with an specific rel (like a namespace: rel='http://schemas.google.com/contacts/2008/rel#photo' )
url -> gContact:website
category -> there is a category field but with no much info
adr -> map with fields from gd:structuredPostalAddress  
tel -> gd:phoneNumber
org -> gd:organization gd:orgName
jobTitle -> gd:organization gd:orgTitle
bday -> gContact:birthday
note -> content
impp -> perhaps gd:im
anniversary -> no found a match
sex -> couldn't found a match
genderIdentity -> couldn't found a match

Comment 4

[Dylan Oliver [:doliver]]

Leo triage: Leo+ for blocking a 1.1 feature.

Comment 5

[Dylan Oliver [:doliver]]

Francisco, please re-assign as necessary.

Comment 6

[Francisco Jordano [:arcturus] [:francisco]]

Sorry, forgot to assign to my self.

Thanks!

Comment 7

[Francisco Jordano [:arcturus] [:francisco]]

Attachment: Pointer to GitHub PR 8389

Comment 8

[Jose Manuel Cantera]

Comment on attachment 719767 [details]
Pointer to GitHub PR 8389

thanks. now next step is the link between FTE and the connector

Comment 9

[Francisco Jordano [:arcturus] [:francisco]]

Landed:

https://github.com/mozilla-b2g/gaia/commit/ebc228c16b4f3e7c52399b0924f7a15c13e5b5bb

Comment 10

[John Ford [:jhford] CET/CEST Berlin Time]

I was not able to uplift this bug to v1-train.  If this bug has dependencies which are not marked in this bug, please comment on this bug.  If this bug depends on patches that aren't approved for v1-train, we need to re-evaluate the approval.  Otherwise, if this is just a merge conflict, you might be able to resolve it with:

  git checkout v1-train
  git cherry-pick -x -m1 ebc228c16b4f3e7c52399b0924f7a15c13e5b5bb
  <RESOLVE MERGE CONFLICTS>
  git commit

Comment 11

[Francisco Jordano [:arcturus] [:francisco]]

Hi John,

It has a dependencies with the bug 843505, so far I checked that one is not uplift.

Do you need anything else?

Cheers!

Comment 12

[John Ford [:jhford] CET/CEST Berlin Time]

(In reply to Francisco Jordano [:arcturus] from comment #11)
> Hi John,
> 
> It has a dependencies with the bug 843505, so far I checked that one is not
> uplift.
> 
> Do you need anything else?
> 
> Cheers!

Francisco, that bug is now leo+, but it has its own merge conflicts.

Comment 13

[Jose Manuel Cantera]

https://github.com/mozilla-b2g/gaia/commit/8ccd2a60f54e322dd2ff6ed35e49e96633535934