Gmail कॉन्टेक्ट्स के साथ काम करना

Aspose.Email Gmail कॉन्टेक्ट्स के साथ काम करने को समर्थन देता है। इसका उपयोग करके IGmailClient इंटरफ़ेस के माध्यम से उपयोगकर्ता Gmail खाते से कॉन्टेक्ट्स प्राप्त कर सकते हैं, नए कॉन्टेक्ट बना सकते हैं, तथा मौजूदा कॉन्टेक्ट को अपडेट या डिलीट कर सकते हैं। Gmail अपने सार्वजनिक डेवलपर API का उपयोग करके इन सभी कार्यों को करने की अनुमति देता है। Gmail कॉन्टेक्ट्स के साथ काम करने के लिए निम्नलिखित उपयोगकर्ता जानकारी आवश्यक है: उपयोगकर्ता नाम, ईमेल पता, पासवर्ड, क्लाइंट आईडी, क्लाइंट सीक्रेट, रीफ़्रेश टोकन।

Gmail कॉन्टेक्ट्स तक पहुंच

नीचे एक नमूना एप्लिकेशन दिया गया है जिसका उपयोग सभी समूहों में कॉन्टैक्ट की विस्तृत जानकारी प्राप्त करने के लिए किया जा सकता है।

        try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
            Contact[] contacts = client.getAllContacts();
            for (Contact contact : contacts)
                System.out.println(contact.getDisplayName() + ", " + contact.getEmailAddresses().get_Item(0));

            // Fetch contacts from a specific group
            ContactGroupCollection groups = client.getAllGroups();
            GoogleContactGroup group = null;
            for (GoogleContactGroup g : groups) {
                if ("TestGroup".equals(g.getTitle())) {
                    group = g;
                }
            }

            // Retrieve contacts from the Group
            if (group != null) {
                Contact[] contacts2 = client.getContactsFromGroup(group.getId());
                for (Contact con : contacts2)
                    System.out.println(con.getDisplayName() + "," + con.getEmailAddresses().get_Item(0).toString());
            }
        }

कॉन्टेक्ट बनाना

नीचे दिया गया कोड स्निपेट दिखाता है कि संपर्क कैसे बनाएं।

// Create a Contact
Contact contact = new Contact();
contact.setPrefix("Prefix");
contact.setGivenName("GivenName");
contact.setSurname("Surname");
contact.setMiddleName("MiddleName");
contact.setDisplayName("DisplayName");
contact.setSuffix("Suffix");

contact.setJobTitle("JobTitle");
contact.setDepartmentName("DepartmentName");
contact.setCompanyName("CompanyName");
contact.setProfession("Profession");

contact.setNotes("Notes");

PostalAddress address = new PostalAddress();
address.setCategory(PostalAddressCategory.getWork());
address.setAddress("Address");
address.setStreet("Street");
address.setPostOfficeBox("PostOfficeBox");
address.setCity("City");
address.setStateOrProvince("StateOrProvince");
address.setPostalCode("PostalCode");
address.setCountry("Country");
contact.getPhysicalAddresses().add(address);

PhoneNumber pnWork = new PhoneNumber();
pnWork.setNumber("323423423423");
pnWork.setCategory(PhoneNumberCategory.getWork());
contact.getPhoneNumbers().add(pnWork);
PhoneNumber pnHome = new PhoneNumber();
pnHome.setNumber("323423423423");
pnHome.setCategory(PhoneNumberCategory.getHome());
contact.getPhoneNumbers().add(pnHome);
PhoneNumber pnMobile = new PhoneNumber();
pnMobile.setNumber("323423423423");
pnMobile.setCategory(PhoneNumberCategory.getMobile());
contact.getPhoneNumbers().add(pnMobile);

contact.getUrls().setBlog("Blog.com");
contact.getUrls().setBusinessHomePage("BusinessHomePage.com");
contact.getUrls().setHomePage("HomePage.com");
contact.getUrls().setProfile("Profile.com");

contact.getEvents().setBirthday(new Date());
contact.getEvents().setAnniversary(new Date());

contact.getInstantMessengers().setAIM("AIM");
contact.getInstantMessengers().setGoogleTalk("GoogleTalk");
contact.getInstantMessengers().setICQ("ICQ");
contact.getInstantMessengers().setJabber("Jabber");
contact.getInstantMessengers().setMSN("MSN");
contact.getInstantMessengers().setQQ("QQ");
contact.getInstantMessengers().setSkype("Skype");
contact.getInstantMessengers().setYahoo("Yahoo");

contact.getAssociatedPersons().setSpouse("Spouse");
contact.getAssociatedPersons().setSister("Sister");
contact.getAssociatedPersons().setRelative("Relative");
contact.getAssociatedPersons().setReferredBy("ReferredBy");
contact.getAssociatedPersons().setPartner("Partner");
contact.getAssociatedPersons().setParent("Parent");
contact.getAssociatedPersons().setMother("Mother");
contact.getAssociatedPersons().setManager("Manager");

// Email Address
EmailAddress eAddress = new EmailAddress();
eAddress.setAddress("[e-mail]");
contact.getEmailAddresses().add(eAddress);
String contactUri = client.createContact(contact);

कॉन्टेक्ट अपडेट करना

जब कोई संपर्क प्राप्त हो जाता है, तो उसके गुणों को अपडेट किया जा सकता है और संपर्क को Gmail खाते में फिर से सहेजा जा सकता है। नीचे दिया गया कोड स्निपेट दिखाता है कि Gmail खाते से संपर्क कैसे प्राप्त करें, उनमें से एक को संशोधित करें और फिर उसे पुनः सहेजें।

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {

    Contact[] contacts = client.getAllContacts();
    Contact contact = contacts[0];
    contact.setJobTitle("Manager IT");
    contact.setDepartmentName("Customer Support");
    contact.setCompanyName("Aspose");
    contact.setProfession("Software Developer");
    client.updateContact(contact);
}

कॉन्टेक्ट हटाना

Gmail संपर्क को हटाने के लिए, नीचे दिए गए नमूना स्निपेट में दिखाए अनुसार Gmail क्लाइंट की DeleteContact मेथड का उपयोग किया जाता है।

client.deleteContact(contact.getId().getGoogleId());

कॉन्टेक्ट सहेजना

Aspose.Email संपर्क को विभिन्न आउटपुट फ़ॉर्मेट जैसे MSG और VCF में सहेजने की सुविधा देता है। Save मेथड इस क्षमता को प्रदान करता है। नीचे दिया गया कोड स्निपेट दिखाता है कि संपर्क कैसे सहेजें।

contact.save(dataDir + "contact_out.msg", ContactSaveFormat.Msg);
contact.save(dataDir + "contact_out.vcf", ContactSaveFormat.VCard);