在 Java 中創建、更新或刪除 Google 日曆

Google 日曆 是一項日程安排服務，可讓您創建和跟踪會議等活動。您可以在日曆上記錄事件並獲得有關即將發生的事件的提醒。 Google 還允許您以編程方式使用其日曆服務。因此，您可以在您的應用程序中使用 Google Calendars 管理您的活動。在本文中，您將了解如何使用 Java 以編程方式創建、更新和刪除 Google 日曆。

• 用於創建和操作 Google 日曆的 Java API
• 用 Java 創建 Google 日曆
• 用 Java 更新 Google 日曆
• 在 Java 中刪除 Google 日曆

用於創建和操作 Google 日曆的 Java API

為了使用 Google Calendar 服務，我們將使用 Aspose.Email for Java。它是一個功能強大的 API，提供了一系列用於處理電子郵件、使用電子郵件客戶端以及使用 Google 的協作服務的功能。您可以 下載 API 或使用以下 Maven 配置安裝它。

存儲庫：

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>http://repository.aspose.com/repo/</url>
</repository>

依賴：

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-email</artifactId>
    <version>22.3</version>
    <classifier>jdk16</classifier>
</dependency>

用 Java 創建 Google 日曆

在開始之前，您需要在 Google Developer Console 上創建一個項目，以便您的應用程序與 Google 的服務進行通信。要創建一個，您可以遵循 本指南。

現在，創建一個名為 GoogleOAuthHelper 的助手類來處理 Google 帳戶的身份驗證。另外，創建一個名為 OAuthUser 的類來存儲用戶信息。以下是這兩個類的完整實現。

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

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>
 * 開發者控制台 https://console.developers.google.com/projectselector/apis/credentials?pli=1 
 * 文檔 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 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) {
            // 忽視
        }
        return result.toString();
    }
}

完成上述配置後，您可以繼續使用 Google Calendar 服務。以下是使用 Java 創建和更新 Google 日曆的步驟。

• 使用 GmailClient.getInstance(String, String) 方法將 GmailClient 類的實例放入 IGmailClient 對像中。
• 創建 Calendar 類的實例並使用名稱、描述和其他屬性對其進行初始化。
• 調用 IGmailClient.createCalendar(Calendar) 方法創建谷歌日曆。
• 獲取返回的日曆 ID。

以下代碼示例顯示瞭如何使用 Java 創建 Google 日曆。

OAuthUser user = new OAuthUser();

// 設置clientId、clientSecret和email 
user.clientId = "<<clientID>>"; 
user.clientSecret = "<<clientSecret>>"; 
user.email = "<<email>>";

// 您必須使用生成的 AuthorizationCodeUrl 手動檢索 AuthorizationCode
// 設置授權碼
String authorizationCode = "<<authCode>>";

// 從上一步輸出複制代碼驗證器
// 設置代碼驗證器
String codeVerifier = "<<codeVerifier>>";

// 獲取刷新令牌
String refreshToken = GoogleOAuthHelper.getAccessTokenByAuthCode(authorizationCode, codeVerifier, user);
user.refreshToken = refreshToken;

// 獲取訪問令牌
String accessToken = GoogleOAuthHelper.getAccessTokenByRefreshToken(user);

// 創建 Gmail 客戶端
try (IGmailClient client = GmailClient.getInstance(accessToken, user.email)) {
    // 插入、獲取和更新日曆
    Calendar calendar = new Calendar("Summary", "Description", "Location", "America/Los_Angeles");

    // 插入日曆並使用 id 檢索相同的日曆
    String id = client.createCalendar(calendar);
}

用 Java 更新 Google 日曆

以下是在 Java 中以編程方式更新 Google 日曆的步驟。

• 使用 GmailClient.getInstance(String, String) 方法將 GmailClient 類的實例放入 IGmailClient 對像中。
• 使用 IGmailClient.fetchCalendar(String) 方法使用其 ID 獲取日曆實例。
• 更新日曆屬性，調用IGmailClient.updateCalendar(Calendar)方法更新日曆。

以下代碼示例顯示瞭如何使用 Java 更新 Google 日曆。

// 創建 Gmail 客戶端
try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // 指定日曆 ID
    String id ="<<calendar ID>>"
      
    // 獲取日曆
    Calendar cal = client.fetchCalendar(id);

    // 更改獲取的日曆中的信息並更新日曆
    cal.setDescription("New Description");
    cal.setLocation("New Location");
  
    // 更新日曆
    client.updateCalendar(cal);
}

在 Java 中刪除 Google 日曆

您還可以使用 Aspose.Email for Java 刪除特定日曆。以下是執行此操作的步驟。

• 使用 GmailClient.getInstance(String, String) 方法將 GmailClient 類的實例放入 IGmailClient 對像中。
• 使用 IGmailClient.listCalendars() 方法獲取日曆列表。
• 遍歷列表並過濾所需的列表。
• 使用 IGmailClient.deleteCalendar(Calendar.getId()) 方法刪除日曆。

以下代碼示例顯示瞭如何使用 Java 刪除 Google 日曆。

// 創建 Gmail 客戶端
try (IGmailClient client = GmailClient.getInstance(accessToken, email)) {
    // 使用從“日曆摘要”開始的摘要訪問和刪除日曆
    String summary = "Calendar summary";

    // 獲取日曆列表
    ExtendedCalendar[] lst = client.listCalendars();

   for (ExtendedCalendar extCal : lst) {
        // 刪除選定的日曆
        if (extCal.getSummary().startsWith(summary))
            client.deleteCalendar(extCal.getId());
    }
}

獲取免費的 API 許可證

您可以獲得免費的臨時許可證，以在沒有評估限制的情況下使用 Aspose.Email for Java。

結論

在本文中，您學習瞭如何使用 Java 以編程方式創建 Google 日曆。此外，您還了解瞭如何使用 Java 更新和刪除特定的 Google 日曆。此外，您可以瀏覽 文檔 以閱讀有關 Aspose.Email for Java 的更多信息。此外，您可以通過我們的 論壇 提問。

也可以看看

• 使用 Java 從 MS Exchange Server 讀取電子郵件
• 使用 Java 創建和發送 Outlook 電子郵件消息