Documentation – Lập trình với Gmail

Java: Tính năng Tiện ích Gmail

Mon, 01 Jan 0001 00:00:00 +0000

Làm việc với Truy vấn FreeBusy

Aspose.Email cung cấp cơ chế truy vấn để kiểm tra xem một cuộc hẹn có đến hạn hay không theo tiêu chí. FreebusyQuery Một lớp được cung cấp cho mục đích này cho phép chuẩn bị truy vấn cho một lịch cụ thể.

Truy vấn lịch

Mẫu mã này minh họa tính năng truy vấn lịch. Các công việc sau được thực hiện trong mẫu này:

Tạo và chèn một lịch
Tạo một cuộc hẹn
Chèn cuộc hẹn
Chuẩn bị một FreebusyQuery
Lấy FreebusyResponse

// Use the OAuthUser and GoogleOAuthHelper classes below to receive an access token
IGmailClient client = GmailClient.getInstance(accessToken, "user@domain.com");
try {
    Calendar newCalendar = new Calendar("summary", null, null, "Europe/Kiev");

    // Insert calendar and get back id of newly inserted calendar and Fetch the same calendar using calendar id
    String id = client.createCalendar(newCalendar);
    Calendar fetchedCalendar = client.fetchCalendar(id);
    String calendarId = fetchedCalendar.getId();
    try {
        // Get list of appointments in newly inserted calendar. It should be zero
        Appointment[] appointments = client.listAppointments(calendarId);

        // Create a new appointment and Calculate appointment start and finish time
        java.util.Calendar c = java.util.Calendar.getInstance();
        Date startDate = c.getTime();
        c.add(java.util.Calendar.HOUR_OF_DAY, 1);
        Date endDate = c.getTime();

        // Create attendees list for appointment
        MailAddressCollection attendees = new MailAddressCollection();
        attendees.add("user1@domain.com");
        attendees.add("user2@domain.com");

        // Create appointment
        Appointment app1 = new Appointment("Location", startDate, endDate, MailAddress.to_MailAddress("user2@domain.com"), attendees);
        app1.setSummary("Summary");
        app1.setDescription("Description");
        app1.setStartTimeZone("Europe/Kiev");
        app1.setEndTimeZone("Europe/Kiev");

        // Insert the newly created appointment and get back the same in case of successful insertion
        Appointment newAppointment = client.createAppointment(calendarId, app1);

        // Create Freebusy query by setting min/max timeand time zone
        FreebusyQuery query = new FreebusyQuery();
        c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.DATE, -1);
        query.setTimeMin(c.getTime());
        c.add(java.util.Calendar.DATE, 2);
        query.setTimeMax(c.getTime());
        query.setTimeZone("Europe/Kiev");

        // Set calendar item to search and Get the reponse of query containing
        query.getItems().add(calendarId);
        FreebusyResponse resp = client.getFreebusyInfo(query);

        client.deleteAppointment(calendarId, newAppointment.getUniqueId());
    } finally {
        client.deleteCalendar(calendarId);
    }
} finally {
    client.dispose();
}

Tạo dự án trong Google Developer Console

Một dự án cần được tạo trên Google Developer Console cho người dùng có tài khoản Gmail. Trong trang API & auth -> Credentials của dự án Google, cần ghi chú thông tin như Client ID và Client Secret. Thông tin này cùng với tên người dùng và mật khẩu tài khoản Gmail sẽ được yêu cầu để thực thi mã, ví dụ: Google Calendar, danh sách kiểm soát truy cập, cuộc hẹn, danh bạ, cài đặt, v.v. trong phần này.

Các bước tạo dự án trong Google Developer Console

Dưới đây là hướng dẫn từng bước để tạo dự án trong Google Developer Console.

Truy cập liên kết https://console.cloud.google.com và đăng nhập bằng thông tin Gmail của bạn
Chọn hộp kiểm "Tôi đã đọc và đồng ý với tất cả các Điều khoản Dịch vụ cho các sản phẩm của Google Cloud Platform." và Nhấn nút NEW PROJECT

Tạo và Chọn dự án mới

Chọn Library và bật API Liên hệ và Lịch

Mở màn hình đồng ý OAuth

Chọn hộp kiểm External và Nhấn nút CREATE

Chỉnh sửa đăng ký ứng dụng và Nhấn nút LƯU VÀ TIẾP TỤC

Thêm phạm vi và Nhấn nút CẬP NHẬT

Tạo thông tin xác thực OAuth

Client ID và Client Secret ở đây sẽ được sử dụng trong các đoạn mã mẫu trong phần này.

Các Lớp Trợ Giúp

Các lớp trợ giúp sau đây là cần thiết để chạy các ví dụ mã trong phần này. Các lớp này GoogleOAuthHelper và OAuthUser chỉ để đơn giản hoá việc trình bày. Các phương thức trong những lớp này sử dụng cấu trúc không công khai của các trang web có thể thay đổi bất kỳ lúc nào.

Lớp GoogleOAuthHelper

Đoạn mã sau cho bạn thấy cách triển khai GoogleOAuthHelper lớp.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

import javax.xml.bind.DatatypeConverter;

/**
 * <p>
 * Developers console https://console.developers.google.com/projectselector/apis/credentials?pli=1 
 * Documentation https://developers.google.com/identity/protocols/OAuth2InstalledApp
 * </p>
 */
class GoogleOAuthHelper {
    public static final String AUTHORIZATION_URL = "https://accounts.google.com/o/oauth2/v2/auth";
    public static final String TOKEN_REQUEST_URL = "https://oauth2.googleapis.com/token";
    public static final String REDIRECT_URI = "urn:ietf:wg:oauth:2.0:oob";
    public static final String REDIRECT_TYPE = "code";
    public static final String SCOPE = "https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar" // Calendar
            + "+https%3A%2F%2Fwww.google.com%2Fm8%2Ffeeds%2F" // Contacts
            + "+https%3A%2F%2Fmail.google.com%2F"; // IMAP & SMTP

    static class OAuthUser {
        String email;
        String clientId;
        String clientSecret;
        String refreshToken;
    }

    static String createCodeChalange() {
        String verifierStr = UUID.randomUUID().toString() + "-" + UUID.randomUUID().toString();
        System.out.println("Code Verifier: " + verifierStr);

        MessageDigest digest;
        try {
            digest = MessageDigest.getInstance("SHA-256");
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalAccessError(e.getMessage());
        }
        byte[] hash = digest.digest(verifierStr.getBytes(StandardCharsets.UTF_8));
        String base64Hash = DatatypeConverter.printBase64Binary(hash);

        base64Hash = base64Hash.split("=")[0];
        base64Hash = base64Hash.replace('+', '-').replace('/', '_');
        return base64Hash;
    }

    static String getAuthorizationCodeUrl(OAuthUser acc) {
        return getAuthorizationCodeUrl(acc, SCOPE, REDIRECT_URI, REDIRECT_TYPE);
    }

    static String getAuthorizationCodeUrl(OAuthUser acc, String scope, String redirectUri, String responseType) {
        System.out.println("---------------------------------------------------------");
        System.out.println("------------- OAuth 2.0 AuthorizationCodeUrl -------------");
        System.out.println("---------------------------------------------------------");
        System.out.println("Login: " + acc.email);
        String codeChallenge = createCodeChalange();

        String state = urlEncode(UUID.randomUUID().toString());
        String approveUrl = AUTHORIZATION_URL + "?client_id=" + acc.clientId + "&redirect_uri=" + redirectUri + "&response_type=" + responseType + "&scope=" + scope
                + "&code_challenge=" + codeChallenge + "&code_challenge_method=S256&state=" + state;

        System.out.println("Approve Url: " + approveUrl);
        return approveUrl;
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String getAccessTokenByAuthCode(String authorizationCode, String codeVerifier, OAuthUser user) {
        String encodedParameters = "client_id=" + urlEncode(user.clientId) + "&client_secret=" + urlEncode(user.clientSecret) + "&code=" + urlEncode(authorizationCode)
                + "&code_verifier=" + codeVerifier + "&redirect_uri=" + urlEncode(REDIRECT_URI) + "&grant_type=authorization_code";
        System.out.println("---------------------------------------------------------");
        System.out.println("------------- OAuth 2.0 AccessTokenByAuthCode -------------");
        System.out.println("---------------------------------------------------------");
        System.out.println("Authorization code: " + authorizationCode);

        String result = "";
        Map<String, String> token = geToken(encodedParameters);
        for (String key : token.keySet()) {
            System.out.println(key + ": " + token.get(key));
            if (key.equals("refresh_token")) {
                result = token.get(key);
            }
        }

        System.out.println("---------------------------------------------------------");

        return result;
    }

    static String getAccessTokenByRefreshToken(OAuthUser user) {
        String encodedParameters = "client_id=" + urlEncode(user.clientId) + "&client_secret=" + urlEncode(user.clientSecret) + "&refresh_token=" + urlEncode(user.refreshToken)
                + "&grant_type=refresh_token";
        System.out.println("---------------------------------------------------------");
        System.out.println("----------- OAuth 2.0 AccessTokenByRefreshToken -----------");
        System.out.println("---------------------------------------------------------");
        System.out.println("Login: " + user.email);

        String result = "";
        Map<String, String> token = geToken(encodedParameters);
        for (String key : token.keySet()) {
            System.out.println(key + ": " + token.get(key));
            if (key.equals("access_token")) {
                result = token.get(key);
            }
        }

        System.out.println("---------------------------------------------------------");

        return result;
    }

    static Map<String, String> geToken(String encodedParameters) {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(TOKEN_REQUEST_URL).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = encodedParameters.getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" + connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<String, String>();
            System.out.println(responseText);
            String[] strs = responseText.replace("{", "").replace("}", "").replace("\"", "").replace("\r", "").replace("\n", "").split(",");
            for (String sPair : strs) {
                String[] pair = sPair.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }
}

Google OAuth Helper nên được sử dụng như sau:

Phải tạo URL mã ủy quyền trước.
Mở URL trong trình duyệt và hoàn thành tất cả các thao tác. Kết quả, bạn sẽ nhận được mã ủy quyền.
Sử dụng mã ủy quyền để nhận token làm mới.
Khi token làm mới tồn tại, bạn có thể sử dụng nó để lấy token truy cập.

static class OAuthUser {
    String email;
    String clientId;
    String clientSecret;
    String refreshToken;
}

static void getRefreshToken() {
    Scanner inputReader = new Scanner(System.in);
    OAuthUser user = new OAuthUser();

    // Set clientId, clientSecret and email
    System.out.println("Set clientId: ");
    user.clientId = inputReader.nextLine();
    System.out.println("Set clientSecret: ");
    user.clientSecret = inputReader.nextLine();
    System.out.println("Set email: ");
    user.email = inputReader.nextLine();

    // Generate AuthorizationCodeUrl
    String authorizationCodeUrl = GoogleOAuthHelper.getAuthorizationCodeUrl(user);

    System.out.println("You have to retrieve AuthorizationCode manually with generated AuthorizationCodeUrl");
    System.out.println("Set authorizationCode: ");
    String authorizationCode = inputReader.nextLine();
    System.out.println("Copy Code Verifier from the previous step output");
    System.out.println("Set codeVerifier: ");
    String codeVerifier = inputReader.nextLine();

    // Get "Refresh Token"
    String refreshToken = GoogleOAuthHelper.getAccessTokenByAuthCode(authorizationCode, codeVerifier, user);
    user.refreshToken = refreshToken;

    // Get "Access Token"
    String accessToken = GoogleOAuthHelper.getAccessTokenByRefreshToken(user);
    
    // Use "Access Token" in API
    IGmailClient client = GmailClient.getInstance(accessToken, user.email);
}

Java: Làm việc với Lịch Gmail

Mon, 01 Jan 0001 00:00:00 +0000

Thêm, Chỉnh sửa và Xóa một Lịch

Aspose.Email cho phép các ứng dụng quản lý các lịch Gmail bằng cách sử dụng IGmailClient cung cấp các tính năng như thêm, xóa và cập nhật các lịch Gmail. Lớp khách hàng này trả về danh sách các đối tượng kiểu ExtendedCalendar chứa thông tin về các mục lịch Gmail. IGmailClient lớp này công khai các hàm sau cho lịch:

createCalendar Để chèn lịch mới
listCalendars

Lấy danh sách tất cả các lịch của một khách hàng

deleteCalendar Nó có thể được dùng để xóa một lịch
fetchCalendar Nó có thể được dùng để lấy lịch cụ thể của một khách hàng
updateCalendar Hàm này được dùng để chèn lại một lịch đã chỉnh sửa của khách hàng

Để truy cập các lịch, GoogleTestUser được khởi tạo bằng thông tin đăng nhập tài khoản Gmail. GoogleOAuthHelper được dùng để lấy token truy cập cho người dùng, sau đó được dùng để khởi tạo IGmailClient.

Chèn, Lấy và Cập nhật

Để chèn một lịch, khởi tạo một Calendar đối tượng kiểu và chèn nó bằng cách sử dụng createCalendar hàm. createCalendar trả về id của lịch mới được chèn. Id này có thể được dùng để lấy lịch từ máy chủ. Đoạn mã sau cho bạn thấy cách chèn, lấy và cập nhật lịch.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // Insert, get and update calendar
    Calendar calendar = new Calendar("Summary", "Description", "Location", "America/Los_Angeles");

    // Insert calendar and Retrieve same calendar using id
    String id = client.createCalendar(calendar);
    Calendar cal = client.fetchCalendar(id);

    // Change information in the fetched calendar and Update calendar
    cal.setDescription("New Description");
    cal.setLocation("New Location");
    client.updateCalendar(cal);
}

Xóa Lịch Cụ Thể

Để xóa một lịch cụ thể, chúng ta cần lấy danh sách tất cả các lịch của một khách hàng và sau đó xóa theo yêu cầu. listCalendars trả về danh sách của ExtendedCalendar chứa các lịch Gmail. Đoạn mã sau cho bạn thấy cách xóa một lịch cụ thể.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // Access and delete calendar with summary starting from "Calendar summary"
    String summary = "Calendar summary";

    // Get calendars list
    ExtendedCalendar[] lst = client.listCalendars();

    for (ExtendedCalendar extCal : lst) {
        // Delete selected calendars
        if (extCal.getSummary().startsWith(summary))
            client.deleteCalendar(extCal.getId());
    }
}

Làm việc với Kiểm soát Truy cập Lịch

Aspose.Email cung cấp kiểm soát đầy đủ đối với quyền truy cập vào các mục lịch. listAccessRules hàm được công khai bởi IGmailClient trả về danh sách của AccessControlRule. Thông tin quy tắc cá nhân có thể được lấy, chỉnh sửa và lưu lại cho lịch của một khách hàng. IGmailClient chứa các hàm sau để quản lý các quy tắc kiểm soát truy cập.

listAccessRules Hàm này cung cấp danh sách của AccessControlRule
createAccessRule Hàm này tạo một quy tắc truy cập mới cho lịch.
updateAccessRule Hàm này được dùng để cập nhật một quy tắc truy cập.
fetchAccessRule Nó có thể được dùng để lấy quy tắc truy cập cụ thể cho lịch của một khách hàng
deleteAccessRule Hàm này được dùng để xóa một quy tắc truy cập.

Đoạn mã sau cho bạn thấy cách các hàm được sử dụng để quản lý các quy tắc truy cập:

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // Retrieve list of calendars for the current client
    ExtendedCalendar[] calendarList = client.listCalendars();

    // Get first calendar id and retrieve list of AccessControlRule for the first calendar
    String calendarId = calendarList[0].getId();
    AccessControlRule[] roles1 = client.listAccessRules(calendarId);

    // Create a local access control rule and Set rule properties
    AccessControlRule rule = new AccessControlRule();
    rule.setRole(AccessRole.reader);
    rule.setScope(new AclScope(AclScopeType.user, email2));

    // Insert new rule for the calendar. It returns the newly created rule
    AccessControlRule createdRule = client.createAccessRule(calendarId, rule);

    // Get list of rules
    AccessControlRule[] roles2 = client.listAccessRules(calendarId);

    // Current list length should be 1 more than the earlier one
    if (roles1.length + 1 == roles2.length) {
        System.out.println("List lengths are ok");
    } else {
        System.out.println("List lengths are not ok");
        return;
    }

    // Change rule and Update the rule for the selected calendar
    createdRule.setRole(AccessRole.writer);
    AccessControlRule updatedRule = client.updateAccessRule(calendarId, createdRule);

    // Retrieve individaul rule against a calendar
    AccessControlRule fetchedRule = client.fetchAccessRule(calendarId, createdRule.getId());

    // Delete particular rule against a given calendar and Retrieve the all rules list for the same calendar
    client.deleteAccessRule(calendarId, createdRule.getId());
    AccessControlRule[] roles3 = client.listAccessRules(calendarId);

    // Check that current rules list length should be equal to the original list length before adding and deleting the rule
    if (roles1.length == roles3.length) {
        System.out.println("List lengths are same");
    } else {
        System.out.println("List lengths are not equal");
        return;
    }
}

Làm việc với Cài đặt Khách hàng và Thông tin Màu

Aspose.Email hỗ trợ truy cập cài đặt Khách hàng bằng cách sử dụng IGmailClient.getSettings. Nó trả về danh sách các cài đặt như dưới đây:

dateFieldOrder
displayAllTimezones
hideInvitations
format24HourTime
defaultCalendarMode
defaultEventLength
locale
remindOnRespondedEventsOnly
alternateCalendar
userLocation
hideWeekends
showDeclinedEvents
weekStart
weather
customCalendarMode
timezoneLabel
timezone
useKeyboardShortcuts
quốc gia

Tương tự, thông tin màu cho khách hàng cũng có thể được lấy bằng cách sử dụng IGmailClient.getColors. Đối tượng thông tin màu này trả về danh sách các màu tiền cảnh, màu nền và ngày giờ cập nhật.

Truy cập Cài đặt Khách hàng

Đoạn mã sau cho bạn thấy cách các hàm được sử dụng để truy cập cài đặt của khách hàng:

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // Retrieve client settings
    Dictionary<String, String> settings = client.getSettings();
    if (settings.size() < 1) {
        System.out.println("No settings are available.");
        return;
    }

    // Traverse the settings list
    for (KeyValuePair<String, String> pair : settings) {
        // Get the setting value and test if settings are ok
        String value = client.getSetting(pair.getKey());
        if (pair.getValue().equals(value)) {
            System.out.println("Key = " + pair.getKey() + ", Value = " + pair.getValue());
        } else {
            System.out.println("Settings could not be retrieved");
        }
    }
}

Truy cập Thông tin Màu

Đoạn mã sau cho bạn thấy cách các hàm được sử dụng để truy cập cài đặt màu của khách hàng.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    ColorsInfo colors = client.getColors();
    Dictionary<String, Colors> palettes = colors.getCalendar();

    // Traverse the settings list
    for (KeyValuePair<String, Colors> pair : palettes) {
        System.out.println("Key = " + pair.getKey() + ", Color = " + pair.getValue());
    }
    System.out.println("Update Date = " + colors.getUpdated());
}

Làm việc với Cuộc hẹn

Aspose.Email cung cấp các tính năng để làm việc với Cuộc hẹn trong lịch Google. Dưới đây là danh sách các tác vụ có thể thực hiện trên cuộc hẹn trong lịch Google:

Thêm cuộc hẹn - createAppointment, importAppointment
Lấy danh sách các cuộc hẹn - listAppointments
Lấy thông tin cuộc hẹn cụ thể - fetchAppointment, listAppointmentInstances
Cập nhật một cuộc hẹn - updateAppointment
Di chuyển cuộc hẹn từ lịch này sang lịch khác - moveAppointment
Xóa cuộc hẹn - deleteAppointment

Thêm Cuộc hẹn

Đoạn mẫu mã sau đây trình bày tính năng thêm cuộc hẹn vào lịch. Trong mẫu này các bước sau được thực hiện:

Tạo và chèn một lịch.
Lấy danh sách các cuộc hẹn từ một lịch mới.
Tạo một cuộc hẹn.
Chèn cuộc hẹn.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // Create local calendar
    Calendar calendar1 = new Calendar("Summary", null, null, "Europe/Kiev");

    // Insert calendar and get id of inserted calendar and Get back calendar using an id
    String id = client.createCalendar(calendar1);
    Calendar cal1 = client.fetchCalendar(id);
    String calendarId1 = cal1.getId();

    try {
        // Retrieve list of appointments from the first calendar
        Appointment[] appointments = client.listAppointments(calendarId1);
        if (appointments.length > 0) {
            System.out.println("Wrong number of appointments");
            return;
        }

        // Get current time and Calculate time after an hour from now
        java.util.Calendar c = java.util.Calendar.getInstance();
        Date startDate = c.getTime();
        c.add(java.util.Calendar.HOUR_OF_DAY, 1);
        Date endDate = c.getTime();

        // Initialize a mail address collection and set attendees mail address
        MailAddressCollection attendees = new MailAddressCollection();
        attendees.add("User1.EMail@domain.com");
        attendees.add("User3.EMail@domain.com");

        // Create an appointment with above attendees
        Appointment app1 = new Appointment("Location", startDate, endDate, MailAddress.to_MailAddress(email2), attendees);

        // Set appointment summary, description, start/end time zone
        app1.setSummary("New Summary");
        app1.setDescription("New Description");
        app1.setStartTimeZone("Europe/Kiev");
        app1.setEndTimeZone("Europe/Kiev");

        // Insert appointment in the first calendar inserted above and get back inserted appointment
        Appointment app2 = client.createAppointment(calendarId1, app1);

        // Retrieve appointment using unique id
        Appointment app3 = client.fetchAppointment(calendarId1, app2.getUniqueId());
    } catch (Exception ex) {
        System.err.println(ex);
    }
    
}

Lấy và Cập nhật Cuộc hẹn

Ở đây việc lấy và cập nhật lịch được minh họa như sau:

Lấy cuộc hẹn cụ thể.
Sửa đổi cuộc hẹn.
Cập nhật cuộc hẹn trong lịch.

Giả sử rằng một lịch có id "calendarId" và cuộc hẹn có ID duy nhất "AppointmentUniqueId" đã được trích xuất. Đoạn mã sau đây cho bạn thấy cách lấy và cập nhật cuộc hẹn.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    String calendarId = client.listCalendars()[0].getId();
    String AppointmentUniqueId = client.listAppointments(calendarId)[0].getUniqueId();

    // Retrieve Appointment
    Appointment app3 = client.fetchAppointment(calendarId, AppointmentUniqueId);
    // Change the appointment information
    app3.setSummary("New Summary");
    app3.setDescription("New Description");
    app3.setLocation("New Location");
    app3.setFlags(AppointmentFlags.AllDayEvent);
    java.util.Calendar c = java.util.Calendar.getInstance();
    c.add(java.util.Calendar.HOUR_OF_DAY, 2);
    app3.setStartDate(c.getTime());
    c.add(java.util.Calendar.HOUR_OF_DAY, 1);
    app3.setEndDate(c.getTime());
    app3.setStartTimeZone("Europe/Kiev");
    app3.setEndTimeZone("Europe/Kiev");
    // Update the appointment and get back updated appointment
    Appointment app4 = client.updateAppointment(calendarId, app3);
}

Di chuyển và Xóa Cuộc hẹn

Appointment có thể được di chuyển bằng cách cung cấp lịch nguồn, lịch đích và ID duy nhất của cuộc hẹn trong lịch nguồn. Đoạn mã sau đây cho bạn thấy cách di chuyển và xóa cuộc hẹn.

try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    String SourceCalendarId = client.listCalendars()[0].getId();
    String DestinationCalendarId = client.listCalendars()[1].getId();
    String TargetAppUniqueId = client.listAppointments(SourceCalendarId)[0].getUniqueId();

    // Retrieve the list of appointments in the destination calendar before moving the appointment
    Appointment[] appointments = client.listAppointments(DestinationCalendarId);
    System.out.println("Before moving count = " + appointments.length);
    Appointment Movedapp = client.moveAppointment(SourceCalendarId, DestinationCalendarId, TargetAppUniqueId);

    // Retrieve the list of appointments in the destination calendar after moving the appointment
    appointments = client.listAppointments(DestinationCalendarId);
    System.out.println("After moving count = " + appointments.length);

    // Delete particular appointment from a calendar using unique id
    client.deleteAppointment(DestinationCalendarId, Movedapp.getUniqueId());

    // Retrieve the list of appointments. It should be one less than the earlier appointments in the destination calendar
    appointments = client.listAppointments(DestinationCalendarId);
    System.out.println("After deleting count = " + appointments.length);
}

Java: Làm việc với Danh bạ Gmail

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email hỗ trợ làm việc với danh bạ Gmail. Sử dụng IGmailClient Giao diện này cho phép người dùng lấy danh bạ từ tài khoản Gmail, tạo danh bạ mới, và cập nhật cũng như xóa danh bạ hiện có. Gmail cho phép các nhà phát triển thực hiện tất cả các thao tác này thông qua API công cộng dành cho nhà phát triển. Các thông tin người dùng sau đây là cần thiết để làm việc với danh bạ Gmail: Tên người dùng, địa chỉ email, mật khẩu, client ID, client secret, refresh token.

Truy cập Danh bạ Gmail

Dưới đây là một ứng dụng mẫu có thể được dùng để truy cập chi tiết danh bạ trong tất cả các nhóm.

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

Tạo Danh bạ

Đoạn mã dưới đây cho thấy cách tạo danh bạ.

// 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("email@gmail.com");
contact.getEmailAddresses().add(eAddress);
String contactUri = client.createContact(contact);

Cập nhật Danh bạ

Khi một danh bạ đã được lấy, các thuộc tính của nó có thể được cập nhật và danh bạ có thể được lưu trở lại tài khoản Gmail. Đoạn mã dưới đây cho thấy cách lấy danh bạ từ tài khoản Gmail và sau đó sửa đổi một danh bạ và lưu lại.

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

Xóa Danh bạ

Để xóa một danh bạ Gmail, phương thức DeleteContact của client Gmail được sử dụng như trong đoạn mã mẫu dưới đây.

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

Lưu Danh bạ

Aspose.Email cho phép lưu danh bạ sang các định dạng đầu ra khác nhau như MSG và VCF. Phương thức Save cung cấp khả năng này. Đoạn mã dưới đây cho thấy cách lưu danh bạ.

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