עבודה עם אנשי קשר של 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, משתמשים במתודת DeleteContact של לקוח Gmail כפי שמוצג בקטע הקוד לדוגמה הבא.

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);