👩🏻 🙍🏽 🍖 Google संपर्क में संपर्क जानकारी सहेजना 🙏 ✍🏼 🐏

शुभ दोपहर, साथियों!

जैसा कि मैंने अपने पिछले लेख में वादा किया था, मैं आपसे Google संपर्क API के उपयोग के संबंध में जानकारी साझा करना चाहता हूं। यदि आप Google एप्लिकेशन इंजन पर Google संपर्क API को जावा से कॉल करने का तरीका सीखने में रुचि रखते हैं, तो बिल्ली में आपका स्वागत है।

मेरे विकास में, मैंने जावा 1.8 के लिए Google एपीआई क्लाइंट लिवार्ड का उपयोग किया - इस संस्करण में नवाचार हैं जो ओथ के माध्यम से प्राधिकरण को सरल बनाते हैं। वास्तव में, अब सभी प्राधिकरण कार्य पुस्तकालय द्वारा किए जाते हैं।

पहले आपको एक वर्ग घोषित करने की आवश्यकता है जो संपर्क की संरचना को प्रदर्शित करेगा। मैंने एक वर्ग बनाया जिसका उपवर्ग संपर्क जानकारी के तत्वों के अनुरूप है - पते, ई-मेल, टेलीफोन और तत्काल संदेशवाहक।

public class Contact implements Serializable { private static final String GDATA_URI = "http://schemas.google.com/g/2005#"; public static final String SOURCE_LABEL = "Source"; public class TypedSubElem implements Serializable{ protected String getURIPrefix(){ return Contact.GDATA_URI; } protected Map<String,String> getRelList(){ final Map<String,String> relList = Collections.unmodifiableMap(new HashMap<String,String>() {{put("home","."); put("other","."); put("work","."); }}); return relList; } @Key("@rel") protected String type = getURIPrefix()+"other"; @Key("@label") protected String label = null; public String getType(){ return (type == null)?null:type.substring(getURIPrefix().length()); } public String getLabel(){ return label; } public String getReadableType(){ String ret = getRelList().get(getType()); if(ret == null) ret = label; return ret; } public void setType(String type){ this.label = null; this.type = getURIPrefix()+(getRelList().containsKey(type)?type:"other"); } public void setLabel(String label){ this.type = null; this.label = label; } } public class FN implements Serializable { @Key("text()") public String text; } public class Content implements Serializable { @Key("text()") public String text; } public class Org extends TypedSubElem { @Key("gd:orgName") public String orgName; @Key("gd:orgTitle") public String orgTitle; @Key("gd:orgDepartment") public String orgDepartment; /** * @param type the type to set */ public void setWork(Boolean work) { setType(work?"work":"other"); } } public class Phone extends TypedSubElem { @Override protected Map<String,String> getRelList(){ final Map<String,String> relList = Collections.unmodifiableMap(new HashMap<String,String>() {{put("assistant",""); put("callback","."); put("car",""); put("company_main",". .")); put("fax",""); put("home","."); put("home_fax",". "); put("isdn","ISDN"); put("main","."); put("mobile","."); put("other","."); put("other_fax",". "); put("pager",""); put("radio",""); put("telex",""); put("tty_tdd","."); put("work","."); put("work_fax",". "); put("work_mob",". ."); put("work_pager",". "); }}); return relList; } @Key("text()") public String text; } public class Email extends TypedSubElem{ @Key("@address") public String address; } public class Address extends TypedSubElem{ @Key("gd:street") public String street; @Key("gd:city") public String city; @Key("gd:region") public String region; @Key("gd:postcode") public String postcode; @Key("gd:country") public String country; @Key("gd:formattedAddress") public String fullAddress; } public class Name extends SubElem{ @Key("gd:givenName") public String givenName; @Key("gd:additionalName") public String additionalName; @Key("gd:familyName") public String familyName; @Key("gd:namePrefix") public String namePrefix; @Key("gd:nameSuffix") public String nameSuffix; @Key("gd:fullName") private String fullName; } public class Link extends TypedSubElem { @Key("@href") public String url; @Override protected Map<String,String> getRelList(){ final Map<String,String> relList = Collections.unmodifiableMap(new HashMap<String,String>() {{put("home-page","."); put("blog",""); put("work","."); put("profile",""); put("other","."); }}); return relList; } @Override protected String getURIPrefix(){ return ""; } } public class IM extends Email { @Key("@protocol") public String protocol; @Override protected Map<String,String> getRelList(){ final Map<String,String> relList = Collections.unmodifiableMap(new HashMap<String,String>() {{put("home","."); put("other","."); put("netmeeting","NetMeeting"); put("work","."); }}); return relList; } protected Map<String,String> getProtoList(){ final Map<String,String> relList = Collections.unmodifiableMap(new HashMap<String,String>() {{put("AIM","AIM"); put("MSN","MSN"); put("YAHOO","Yahoo"); put("SKYPE","Skype"); put("QQ","QQ"); put("GOOGLE_TALK","GTalk"); put("ICQ","ICQ"); put("JABBER","Jabber"); }}); return relList; } public String getProtocol(){ return (protocol == null)?null:protocol.substring(protocol.lastIndexOf('#')+1); } public String getReadableProto(){ return getProtoList().get(getProtocol()); } public void setProtocol(String type){ this.protocol = (getProtoList().containsKey(type))?GDATA_URI+type:null; } } @Key("gContact:website") public List<Link> links = new ArrayList<Link>(); @Key public Content content; @Key("title") public FN fn; @Key("gd:phoneNumber") public List<Phone> phones = new ArrayList<Phone>(); @Key("gd:email") public List<Email> emails = new ArrayList<Email>(); @Key("gd:organization") public List<Org> orgs = new ArrayList<Org>(); @Key("gd:structuredPostalAddress") public List<Address> addresses = new ArrayList<Address>(); @Key("gd:im") public List<IM> IMs = new ArrayList<IM>(); @Key("gd:name") public Name name; }

वर्ग और उसके उपवर्गों को सीरियल-योग्य घोषित किया जाता है - यह Google API क्लाइंट को संपर्क को सही एटम में बदलने में सक्षम करेगा। ऐसा करने के लिए, उन सभी फ़ील्ड्स को सहेजना चाहिए जिन्हें एनोटेट किया गया है @‌Key - यह हमारी कक्षा के क्षेत्रों के पत्राचार और एटम संरचना को इंगित करता है।

रिले और लेबल फ़ील्ड एक अलग स्पष्टीकरण के लायक हैं। rel एक पूर्वनिर्धारित सूची से संपर्क जानकारी का एक विशिष्ट अंकन है। उदाहरण के लिए, ई-मेल के लिए यह एक संकेत होगा कि पता घर है या काम। " APIas.google.com/g/2005# <view>" फ़ॉर्म का मान Google API को दिया जाता है। लेकिन ठेठ चिह्नों के अलावा, संपर्क जानकारी को एक मनमाना पदनाम के साथ चिह्नित किया जा सकता है। ऐसा करने के लिए, लेबल फ़ील्ड का उपयोग करें। Google API को उम्मीद है कि उनमें से एक को आबादी दी जाएगी - या तो rel या लेबल।

आप यहां संपर्क डेटा संरचना के बारे में अधिक पढ़ सकते हैं।

Google को एक संपर्क भेजने के लिए, एक सर्वलेट बनाएं जो AbstractAppEngineAuthorizationCodeServlet से विरासत में मिला है। यह वर्ग आपको स्वचालित रूप से यह जांचने की अनुमति देता है कि क्या कोई उपयोगकर्ता अधिकृत है (Google खातों में प्राधिकरण के माध्यम से या, यदि आप Google Apps इंजन में उपयुक्त सेटिंग्स सेट करते हैं, तो Federated Login का उपयोग करके)। यदि उपयोगकर्ता अधिकृत है, तो उससे पूछा जाएगा (फिर से लाइब्रेरी सर्वलेट का उपयोग करके - आपको Google संपर्कों में अपने संपर्कों तक पहुंचने की अनुमति के लिए स्वयं कुछ भी लिखने की आवश्यकता नहीं है)। प्राप्त टोकन टोकन स्टोर में भविष्य के उपयोग के लिए सहेजे जाएंगे (मैंने AppEngineCredentialStore का उपयोग किया था)। क्रियाओं का संपूर्ण अनुक्रम GoogleAuthorizationCodeFlow की जिम्मेदारी है।

 import com.google.api.client.auth.oauth2.AuthorizationCodeFlow; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.extensions.appengine.auth.oauth2.AbstractAppEngineAuthorizationCodeServlet; import com.google.api.client.extensions.appengine.auth.oauth2.AppEngineCredentialStore; import com.google.api.client.extensions.appengine.http.urlfetch.UrlFetchTransport; import com.google.api.client.googleapis.GoogleHeaders; import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow; import com.google.api.client.http.*; import com.google.api.client.http.xml.atom.AtomContent; import com.google.api.client.json.JsonFactory; import com.google.api.client.json.jackson.JacksonFactory; import com.google.api.client.xml.XmlNamespaceDictionary; import java.io.IOException; import java.util.Collections; import java.util.ResourceBundle; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class Action extends AbstractAppEngineAuthorizationCodeServlet { private static final String DEFAULT_BASE_URL = "https://www.google.com/m8/feeds/contacts/default/full"; public static final String SCOPE = "https://www.google.com/m8/feeds/"; public static final String CALLBACK_URI = "/action/google_contacts/oauth2callback"; private static final String APP_NAME = "< >"; public static final String CLIENT_ID = "< >"; public static final String CLIENT_SECRET = "<>"; private static final HttpTransport transport = new UrlFetchTransport(); private static final JsonFactory jsonFactory = new JacksonFactory(); static final XmlNamespaceDictionary DICTIONARY = new XmlNamespaceDictionary() .set("", "http://www.w3.org/2005/Atom") .set("gd", "http://schemas.google.com/g/2005") .set("gContact", "http://schemas.google.com/contact/2008"); @Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException{ Credential credential = getCredential(); Contact contact = (Contact) request.getSession().getAttribute("Contact"); if(credential != null && contact != null) { HttpRequestFactory requestFactory = transport.createRequestFactory(getCredential()); assert requestFactory!=null; HttpRequest req = requestFactory.buildPostRequest(new GenericUrl(DEFAULT_BASE_URL), null); GoogleHeaders headers = new GoogleHeaders(); headers.setApplicationName(APP_NAME); headers.setGDataVersion("3"); req.setHeaders(headers); AtomContent content = AtomContent.forEntry(DICTIONARY, contact); req.setContent(content); try{ HttpResponse resp = req.execute(); } catch (HttpResponseException e) { } } } @Override protected String getRedirectUri(HttpServletRequest req) throws ServletException, IOException { GenericUrl url = new GenericUrl(req.getRequestURL().toString()); url.setRawPath(CALLBACK_URI); return url.build(); } @Override protected AuthorizationCodeFlow initializeFlow() throws IOException { return new GoogleAuthorizationCodeFlow.Builder(new UrlFetchTransport(), new JacksonFactory(), CLIENT_ID, CLIENT_SECRET, Collections.singleton(SCOPE)).setCredentialStore( new AppEngineCredentialStore()).build(); } }

सिद्धांत रूप में, अनुरोध हेडर सेट नहीं किया जा सकता है, लेकिन इस मामले में, Google एपीआई का मानना है कि संपर्क संस्करण 2 है, जो विशेष रूप से संपर्क के संरचित नाम का उपयोग नहीं करता है, लेकिन इसके बजाय एफएन का उपयोग करता है। इसके अलावा, अगर मैं गलत नहीं हूं, तो इस संस्करण में IM डेटा सहेजा नहीं गया है।

आप प्रलेखन पृष्ठ पर संपर्क एपीआई के अन्य तरीकों के बारे में अधिक पढ़ सकते हैं।

Google संपर्क में संपर्क जानकारी सहेजना

More articles: