Documentation – ทำงานกับ Microsoft Graph Client

Java: การตั้งค่า Azure AD & การรับรอง Microsoft Graph - Aspose.Email for Java

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

Aspose.Email for Java มีการผสานรวมเต็มรูปแบบกับ Microsoft Graph ช่วยให้นักพัฒนาจัดการข้อความ รายชื่อผู้ติดต่อ ปฏิทิน และงานจากบัญชี Microsoft 365 คู่มือชี้แนะคุณผ่านการสร้างแอป Azure AD และการกำหนดค่าการรับรองเพื่อเริ่มเขียนโค้ดด้วย Aspose.Email GraphClient.

ก่อนใช้ Microsoft Graph API กับ Aspose.Email คุณต้องลงทะเบียนแอปใน Azure Active Directory (Azure AD) และกำหนดค่าการรับรอง หน้านี้ครอบคลุม:

สร้างแอปพลิเคชัน Azure AD (โครงการ).
กำหนดสิทธิ์ Microsoft Graph ที่จำเป็น.
สร้างข้อมูลรับรอง (client ID, client secret, tenant ID).
การรับรองใน Java ด้วยผู้ให้โทเค็น Aspose.Email.

เมื่อเสร็จสิ้น คุณจะพร้อมโต้ตอบกับ Microsoft Graph จากแอป Java ของคุณ.

1. สร้างแอปพลิเคชัน Azure AD

ทำตามขั้นตอนเหล่านี้เพื่อลงทะเบียนแอปของคุณในพอร์ทัล Azure:

เข้าสู่ระบบที่ พอร์ทัล Azure.
ไปที่ Azure Active Directory → App Registrations → New Registration.

ใส่ Name สำหรับแอปของคุณ (เช่น AsposeEmailGraphApp).
เลือกประเภทบัญชีที่รองรับ:
- Single tenant (หากมีเพียงองค์กรของคุณเท่านั้นที่จะใช้)
- Multitenant (หากหลายองค์กรต้องการเข้าถึง)
หากต้องการ สามารถตั้งค่า Redirect URI (จำเป็นสำหรับการรับรองแบบโต้ตอบหรือเว็บ)
คลิก Register.

2. สร้าง Client Secret

หลังจากลงทะเบียน ไปที่ Certificates & Secrets → New Client Secret.
เพิ่มคำอธิบายและระยะเวลาหมดอายุ.

คัดลอกค่าความลับที่สร้างขึ้น - คุณจะไม่เห็นอีกครั้ง

เก็บ client secret ไว้อย่างปลอดภัย; จำเป็นสำหรับการรับรองของ confidential client.

คุณควรเห็นแถบแอปที่ลงทะเบียนใหม่

3. ตั้งค่าสิทธิ์ Microsoft Graph

ไปที่ API Permissions → Add a Permission → Microsoft Graph.
เลือกประเภทของสิทธิ์: Delegated หรือ Application ขึ้นอยู่กับสถานการณ์ของคุณ.
เพิ่มสิทธิ์ที่จำเป็นสำหรับการดำเนินการของ Aspose.Email:
- Contacts.ReadWrite – เพื่อจัดการรายชื่อผู้ติดต่อ
- Calendars.ReadWrite – เพื่อจัดการปฏิทิน
- Mail.ReadWrite – เพื่ออ่านและส่งข้อความ
- Tasks.ReadWrite – เพื่อจัดการงาน
คลิก Grant Admin Consent หากจำเป็น.

4. อนุญาตการไหลของลูกค้าสาธารณะ

ระบุว่าแอปพลิเคชันเป็นลูกค้าสาธารณะหรือไม่ เหมาะสำหรับแอปที่ใช้การให้โทเค็นโดยไม่ใช้ URI การเปลี่ยนเส้นทาง

5. การรับรอง Microsoft Graph

วิธีการรับรองที่สนับสนุนใน Aspose.Email

รับรองด้วย Confidential Client

ใช้ AzureConfidentialTokenProvider เพื่อรับรองเมื่อคุณมี client ID, client secret, และ tenant ID:

AzureConfidentialTokenProvider provider = new AzureConfidentialTokenProvider(
    tenantId,
    clientId,
    clientSecret
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

สิ่งนี้ตั้งค่า IGraphClient ที่ได้รับการรับรองอย่างสมบูรณ์พร้อมโต้ตอบกับ Microsoft Graph.

รับรองด้วย ROPC (ชื่อผู้ใช้ & รหัสผ่าน)

สำหรับสถานการณ์ที่คุณมีชื่อผู้ใช้และรหัสผ่าน ให้ใช้ AzureROPCConfiguration:

AzureROPCConfiguration ropcConfig = new AzureROPCConfiguration(
    tenantId,
    clientId,
    clientSecret,
    username,
    password
);

IGraphClient client = GraphClient.getClient(ropcConfig, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

ผู้ให้โทเค็นแบบกำหนดเองสำหรับ Microsoft Graph

Aspose.Email for Java ผสานรวมกับ Microsoft Graph ผ่าน IGraphClient อินเทอร์เฟซ เพื่อรับรองคำขอ จำเป็นต้องมีการทำงานของ ITokenProvider จำเป็นต้องใช้ ในขณะที่นักพัฒนาส่วนใหญ่จะใช้ผู้ให้การรับรองที่มีมาแล้ว แต่บางกรณีคุณอาจต้องการสร้างผู้ให้ของคุณเอง ตัวอย่างเช่นเมื่อทำงานกับการไหล Resource Owner Password Credentials (ROPC)

1. ดำเนินการ ITokenProvider ด้วย AzureROPCTokenProvider

คลาสนี้ให้การทำงานของ ITokenProvider โดยใช้การไหล Azure Resource Owner Password Credentials (ROPC) ตัวอย่างต่อไปนี้ใช้เพื่อการสาธิตเท่านั้น ในการใช้งานจริง เราขอแนะนำให้ใช้การไหลที่ปลอดภัยกว่าเช่น client credentials หรือ authorization code กับ PKCE.

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.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = getToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> getToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().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[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.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 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 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();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

2. สร้างอ็อบเจกต์ ITokenProvider

นี้ IGraphClient อินเทอร์เฟซรับผิดชอบในการสร้างคำขอ ส่งไปยัง Microsoft Graph และจัดการการตอบกลับ เพื่อสร้างอินสแตนซ์ของ IGraphClient, คุณต้องให้การทำงานของ ITokenProvider. ผู้ให้โทเค็นทำการรับรองคำขอโดยให้โทเค็นการเข้าถึง OAuth ที่ถูกต้อง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างการใช้งานแบบอินไลน์พื้นฐานของ ITokenProvider อินเทอร์เฟซที่จำเป็นสำหรับการรับรองความถูกต้องของคำขอ Microsoft Graph:

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
        // Clean up resources if necessary
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Retrieve an OAuth access token.
        // If ignoreExistingToken is true, always request a new token.
        // Otherwise, return the existing token if it is valid, or request a new one.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Return a valid OAuth token.
        // If no valid token exists, request a new one.
        return new OAuthToken("token", expirationDate);
    }
};

3. การใช้ผู้ให้โทเค็นแบบกำหนดเอง

เมื่อ ITokenProvider เมื่อตั้งค่าเสร็จ คุณสามารถสร้าง GraphClient อินสแตนซ์ ไคลเอนท์นี้จะใช้ตัวจัดหาตัวโทเคนที่ให้เพื่อการยืนยันตัวเมื่อเรียก Microsoft Graph

ITokenProvider provider = new AzureROPCTokenProvider(
        tenantId,
        clientId,
        clientSecret,
        userName,
        password,
        new String[] {"https://graph.microsoft.com/.default"}
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(userName);
client.setEndpoint("https://graph.microsoft.com");

// Now you can call Microsoft Graph APIs
var folders = client.listFolders(null);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

หลังจากสร้างและยืนยันตัวคลไอเอนท์แล้ว คุณสามารถเริ่มทำคำขอไปยังบริการ Microsoft Graph ได้

Java: คุณลักษณะยูทิลิตี้ของ Microsoft Graph

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

การสร้างโครงการใน Azure Active Directory Admin Center

โครงการจะถูกสร้างใน Azure Active Directory admin center สำหรับผู้ใช้ที่มีบัญชี MS Office.

ขั้นตอนการสร้างโครงการใน Azure Active Directory Admin Center

ต่อไปนี้เป็นบทแนะนำขั้นตอนต่อขั้นตอนสำหรับการสร้างโครงการใน Azure Active Directory admin center.

1. ไปที่ Azure Active Directory แล้วเข้าสู่ระบบด้วยข้อมูลประจำตัว MS Office ของคุณ.

Azure Active Directory ลิงก์ - https://aad.portal.azure.com/

2. สร้างแอปพลิเคชัน Azure AD ใน tenant ของคุณ.

ในแผนด้านซ้ายคลิกป้าย Azure Active Directory จะเปิดแถบสำหรับ Azure Active Directory ในหน้าจอนั้นควรเห็นป้าย App registrations นี้เป็นจุดเริ่มต้นของการลงทะเบียนแอป Azure AD แถบนี้จะให้คุณสร้างแอปใหม่สำหรับ Azure AD.

คลิกปุ่ม New registration เพื่อสร้างแอปใหม่.

3. ตอนนี้คุณจะเห็นแถบการลงทะเบียนแอปใหม่.

Name นี่จะเป็นชื่อของแอปของคุณ.
Supported account types ส่วนนี้จะจำกัดการเข้าถึง.

คลิกปุ่ม Register.

4. คุณควรเห็นแถบแอปที่ลงทะเบียนใหม่.

Application (client) ID ID ของแอปของคุณ.
Directory (tenant) ID ID ของ tenant Azure AD.

5. อนุญาตสิทธิ์สำหรับ Microsoft Graph API.

คลิกที่ป้าย API permissions.

Azure ได้ให้สิทธิ์ User.Read แบบ delegated สำหรับแอปของคุณแล้ว สิทธิ์นี้จะอนุญาตให้เราอ่านข้อมูลผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบ สิ่งเหล่านี้คือสิทธิ์ของ Microsoft Graph API อีกด้านหนึ่งเราอาจเรียกว่าตัว Scopes.

รายการเต็มของ scopes สำหรับ Microsoft Graph API - https://docs.microsoft.com/en-us/graph/permissions-reference.

คลิกปุ่ม + Add a permission แล้วเลือก Microsoft Graph.

คลิกที่ Delegated permissions ตอนนี้คุณจะเห็นรายการสิทธิ์ที่มีสำหรับ Microsoft Graph API.

เลือกสิทธิ์ที่ต้องการ แล้วคลิกปุ่ม Add permissions.

คลิกปุ่ม Grant admin consent.

6. อนุญาตการไหลของลูกค้าสาธารณะ.

ระบุว่าแอปเป็นลูกค้าสาธารณะหรือไม่ เหมาะสำหรับแอปที่ใช้การให้โทเค็นโดยไม่ใช้ URI การเปลี่ยนเส้นทาง.

7. สร้างคีย์สำหรับแอปพลิเคชัน

คลาสช่วยเหลือ

คลาสช่วยเหลือต่อไปนี้จำเป็นสำหรับการรันโค้ดในส่วนนี้ คลาสเหล่านี้ใช้เพื่อทำให้การสาธิตง่ายขึ้นเท่านั้น.

คลาส AzureROPCTokenProvider

อินสแตนซ์ของ IGraphClient คลาสนี้จัดการการสร้างคำขอ ส่งไปยัง Microsoft Graph API และประมวลผลการตอบกลับ เพื่อสร้างอินสแตนซ์ใหม่ของคลาสนี้ คุณต้องให้อินสแตนซ์ของ ITokenProvider, ซึ่งสามารถรับรองคำขอไปยัง Microsoft Graph.

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.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

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

            byte[] requestData = getEncodedParameters().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[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.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 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 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();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

Java: ทำงานกับ Microsoft Graph ใน Aspose.Email for Java

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

Aspose.Email for Java ให้การบูรณาการที่เชื่อถือได้กับ Microsoft Graph ทำให้นักพัฒนาสามารถเข้าถึงและจัดการข้อมูลกล่องจดหมาย เช่น ข้อความ โฟลเดอร์ ผู้ติดต่อ ปฏิทิน และงาน โดยใช้ IGraphClient API คุณสามารถตรวจสอบสิทธิ์ ทำการสอบถาม และดำเนินการบนบัญชี Microsoft 365 โดยตรงจากแอปพลิเคชัน Java ของคุณ.

ส่วนต่อไปนี้ครอบคลุมด้านต่าง ๆ ของการทำงานกับ Microsoft Graph ใน Aspose.Email for Java:

การตรวจสอบสิทธิ์กับ Microsoft Graph

ใช้การสอบถาม OData ใน Microsoft Graph

จัดการผู้ติดต่อใน Microsoft Graph

จัดการปฏิทินใน Microsoft Graph

จัดการงานใน Microsoft Graph

แต่ละหน้ารวมถึงคำอธิบายอย่างละเอียด วิธีการ API ที่พร้อมใช้งาน และตัวอย่างโค้ด

Java: การจัดการกล่องจดหมายด้วย Microsoft Graph

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

นอกเหนือจากการทำงานกับข้อความ โฟลเดอร์ และไฟล์แนบ Aspose.Email for Java ยังอนุญาตให้คุณจัดการคุณลักษณะระดับกล่องจดหมาย เช่น หมวดหมู่ การ Override ของกล่องจดหมายสำคัญ และกฎต่าง ๆ คุณสามารถทำงานกับหลายกล่องจดหมายโดยสลับบริบทของทรัพยากร การดำเนินการเหล่านี้พร้อมใช้งานผ่านการบูรณาการกับ Graph API

วิธีทำงานกับ Outlook Categories

Categories ใน Outlook ช่วยให้คุณจัดกลุ่มและติดฉลากข้อความเพื่อความเป็นระเบียบง่ายขึ้น ด้วย Aspose.Email คุณสามารถสร้าง ดึง อัปเดต แสดงรายการ และลบหมวดหมู่ได้โดยโปรแกรม

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

วิธีทำงานกับ Overrides

Overrides ควบคุมว่าข้อความจากผู้ส่งบางรายจะถูกจัดการอย่างไรในกล่องจดหมายสำคัญ (Focused Inbox) ตัวอย่างเช่น คุณสามารถบังคับให้ข้อความจากผู้ส่งที่ระบุปรากฏเสมอในมุมมองสำคัญ

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

วิธีทำงานกับกฎของ Outlook

กฎของกล่องจดหมายช่วยให้คุณทำงานอัตโนมัติ เช่น การส่งต่อข้อความหรือการกรองตามเงื่อนไข API Graph อนุญาตให้สร้าง ดึง อัปเดต แสดงรายการ และลบกฎของกล่องจดหมายเข้า

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

การทำงานกับหลายกล่องจดหมาย - การสลับบริบทของกล่องจดหมาย

โดยค่าเริ่มต้น การดำเนินการจะทำกับกล่องจดหมายของผู้ใช้ปัจจุบัน คุณสามารถสลับบริบทไปยังกล่องจดหมายอื่น (เช่น เพื่อแสดงรายการข้อความจากกล่องจดหมายแชร์) โดยการตั้งค่าชนิดของทรัพยากรและรหัสทรัพยากร

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

การสอบถาม OData กับ Microsoft Graph

Aspose.Email for Java ให้การสนับสนุนการสอบถาม OData เมื่อทำงานกับ Microsoft Graph มันทำให้คุณสามารถทำการกรองขั้นสูง การเรียงลำดับ การคัดเลือกรายการ การแบ่งหน้า และการขยายเมื่อดึงทรัพยากร เช่น โฟลเดอร์ ข้อความ ผู้ติดต่อ และรายการปฏิทิน ได้ ODataQueryBuilder คลาสนี้อนุญาตให้คุณสร้างพารามิเตอร์การสอบถาม OData อย่างเป็นระเบียบและนำกลับมาใช้ใหม่ได้ แทนการสร้างสตริงการสอบถามด้วยตนเอง วิธีต่อไปนี้สามารถใช้สำหรับการนับและค้นหาในชุดข้อมูลขนาดใหญ่:

Select เพื่อดึงเฉพาะคุณสมบัติที่คุณต้องการ.
Filter เพื่อใช้ฟิลเตอร์.
OrderBy เพื่อเรียงผลลัพธ์.
Top และ Skip สำหรับการแบ่งหน้า.
Expand เพื่อขยายเอนทิตี้ที่เกี่ยวข้องในคำสอบถามเดียว

หลาย ๆ GraphClient เมธอดรับค่า optional ODataQueryBuilder พารามิเตอร์สำหรับใช้งานการสอบถาม OData รวมถึง:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการใช้ ODataQueryBuilder เพื่อสอบถามโฟลเดอร์และดึงข้อความพร้อมฟิลเตอร์ขั้นสูงและการแบ่งหน้า:

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}

Java: จัดการงานใน Microsoft Graph ด้วย Aspose.Email for Java

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

ดูเพิ่มเติมที่ การตั้งค่า Azure AD และการรับรอง Microsoft Graph บทความเพื่อเรียนรู้วิธีบูรณาการแอปพลิเคชันของคุณกับ Microsoft Graph.

Aspose.Email for Java ให้การสนับสนุนการจัดการงานผ่าน Microsoft Graph คุณสามารถระบุรายการงาน สร้างหรือทำลายรายการเหล่านั้น และจัดการงานด้วยตัวเลือกการอัปเดตที่ยืดหยุ่น

ตัวอย่างโค้ดด้านล่างแสดงวิธีการจัดการรายการงานและงานโดยใช้เมธอดต่อไปนี้ของ GraphClient คลาส:

listTaskLists() — ดึงรายการงานทั้งหมด.
getTaskList(String id) — ดึงรายการงานเฉพาะ.
deleteTaskList(String id) — ลบรายการงาน.
listTasks(String id) — ดึงรายการงานสำหรับรายการงานที่กำหนด
fetchTask(String id) — ดึงงานโดยใช้ ID.
createTask(MapiTask task, String taskListUri) — สร้างงานในรายการงานเฉพาะ
updateTask(MapiTask task) — อัปเดตงานที่มีอยู่.
updateTask(MapiTask task, UpdateSettings updateSettings) — อัปเดตงานด้วยการตั้งค่าการอัปเดตเฉพาะ

// List Task Lists
GraphTaskListInfoCollection taskLists = graphClient.listTaskLists();
for (GraphTaskListInfo tList : taskLists) {
    System.out.println("Task List: " + tList.getDisplayName());
}

// Get Task List
GraphTaskListInfo taskList = graphClient.getTaskList("taskListId");

// Delete Task List
graphClient.deleteTaskList("taskListId");

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.listTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.fetchTask("taskId");

// Create Task
MapiTask newTask = new MapiTask();
newTask.setSubject("New Task");
newTask.setDueDate(new Date());
newTask.setStatus(MapiTaskStatus.NotStarted);

MapiTask createdTask = graphClient.createTask(newTask, "taskListUri");

// Update Task
createdTask.setSubject("Updated Task Subject");
MapiTask updatedTask = graphClient.updateTask(createdTask);

// Update Task with UpdateSettings
UpdateSettings updateSettings = new UpdateSettings();
updateSettings.setSkipAttachments(true);
MapiTask updatedTaskWithSettings = graphClient.updateTask(createdTask, updateSettings);

Java: จัดการรายการปฏิทินใน Microsoft Graph

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

Aspose.Email for Java ให้การสนับสนุนการจัดการรายการปฏิทินผ่าน Microsoft Graph คุณสามารถแสดงรายการปฏิทิน ทำงานกับเหตุการณ์ปฏิทิน และอัปเดตรายการโดยมีหรือไม่มีการตั้งค่าอัปเดตได้

ตัวอย่างโค้ดด้านล่างแสดงวิธีการจัดการรายการปฏิทินโดยใช้เมธอดต่อไปนี้ของ GraphClient คลาส:

listCalendars() — ดึงชุดของปฏิทินที่พร้อมใช้งาน.
listCalendarItems(String id) — ดึงรายการปฏิทินสำหรับปฏิทินเฉพาะหนึ่ง.
fetchCalendarItem(String id) — ดึงรายการปฏิทินตาม ID ของมัน.
createCalendarItem(String calId, MapiCalendar mapiCalendar) — สร้างรายการปฏิทินใหม่.
updateCalendarItem(MapiCalendar mapiCalendar) — อัปเดตรายการปฏิทินที่มีอยู่.
updateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — อัปเดตรายการปฏิทินด้วยการตั้งค่าการอัปเดตที่กำหนดเอง.

// List Calendars
GraphCalendarInfoCollection calendars = graphClient.listCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.listCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.fetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar();
newCalendarItem.setLocation("Conference Room");
newCalendarItem.setSubject("Team Meeting");
newCalendarItem.setBody("Discuss project status and updates.");
newCalendarItem.setStartDate(startDate);
newCalendarItem.setEndDate(endDate);

MapiCalendar createdCalendarItem = graphClient.createCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.setLocation("Zoom Meeting");
MapiCalendar updatedCalendarItem = graphClient.updateCalendarItem(createdCalendarItem);

Java: จัดการรายชื่อผู้ติดต่อใน Microsoft Graph ด้วย Aspose.Email for Java

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

Aspose.Email for Java ให้การสนับสนุนการจัดการผู้ติดต่อผ่าน Microsoft Graph คุณสามารถแสดงรายการ ดึงข้อมูล สร้าง และอัปเดตผู้ติดต่อโดยตรงจากโฟลเดอร์ผู้ติดต่อได้

ตัวอย่างโค้ดด้านล่างแสดงวิธีการจัดการรายการผู้ติดต่อโดยใช้เมธอดต่อไปนี้ของไลบรารี:

listContacts(String id) — ดึงชุดของผู้ติดต่อจากโฟลเดอร์ที่ระบุ.
fetchContact(String id) — ดึงผู้ติดต่อโดยใช้ ID.
createContact(String folderId, MapiContact contact) — สร้างผู้ติดต่อใหม่ในโฟลเดอร์.
updateContact(MapiContact contact) — อัปเดตผู้ติดต่อที่มีอยู่.

IGraphClient graphClient = null;

// List Contacts
MapiContactCollection contacts = graphClient.listContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.fetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");
MapiContact createdContact = graphClient.createContact("contactFolderId", newContact);

// Update Contact
createdContact.getTelephones().setPrimaryTelephoneNumber("888-888-999");
MapiContact updatedContact = graphClient.updateContact(createdContact);

Java: ทำงานกับข้อความโดยใช้ Microsoft Graph

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

Aspose.Email for Java มีชุด API ที่ครอบคลุมสำหรับการจัดการข้อความผ่าน Microsoft Graph คุณสามารถแสดงรายการ ดึง สร้าง อัปเดต ย้าย คัดลอก และลบข้อความ รวมถึงจัดการการแบ่งหน้าและไฟล์แนบ ตัวอย่างโค้ดด้านล่างเป็นตัวอย่างของการดำเนินการที่พบบ่อยที่สุด.

แสดงรายการข้อความ

คุณสามารถดึงข้อความจากโฟลเดอร์เฉพาะ เช่น Inbox และดึงเนื้อหาครบถ้วนของมันได้:

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

แสดงรายการข้อความตามวันที่ส่ง

เพื่อเรียงข้อความตามวันที่ส่งในลำดับจากน้อยไปมาก คุณสามารถใช้ OrderBy ฟีเจอร์ของ GraphQueryBuilder:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

ดึงข้อความ

เมื่อคุณมีอ้างอิงข้อความแล้ว คุณสามารถดึงเนื้อหาเต็มของข้อความได้:

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

อัปเดตข้อความ

หลังจากดึงข้อความ คุณสามารถแก้ไขเนื้อหาและอัปเดตบนเซิร์ฟเวอร์ได้:

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

การแบ่งหน้าในรายการข้อความ

เมื่อทำงานกับกล่องจดหมายขนาดใหญ่ คุณสามารถใช้การแบ่งหน้าเพื่อดึงข้อความเป็นส่วนๆ ตัวอย่างด้านล่างแสดงการแสดงรายการข้อความที่ยังไม่ได้อ่านเป็นหน้าโดยมีสองรายการต่อหน้า:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

สร้างข้อความ

คุณสามารถสร้างข้อความใหม่พร้อมหัวเรื่อง เนื้อหา และคุณสมบัติต่างๆ:

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

ส่งข้อความ

คุณสามารถส่งข้อความโดยตรงได้:

client.send(message);

หรือส่งข้อความร่างหลังจากสร้างในโฟลเดอร์ Drafts:

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

คัดลอกและย้ายข้อความ

ข้อความสามารถคัดลอกหรือย้ายระหว่างโฟลเดอร์ได้:

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());
MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

จัดการไฟล์แนบ

เพื่อแสดงรายการและลบไฟล์แนบจากข้อความ ใช้ตัวอย่างโค้ดต่อไปนี้:

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

ลบข้อความ

สุดท้าย คุณสามารถลบข้อความอย่างถาวร:

client.delete(message.getItemId());

Java: ทำงานกับโฟลเดอร์โดยใช้ Microsoft Graph

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

Aspose.Email for Java ช่วยให้คุณทำการดำเนินการกับโฟลเดอร์ต่าง ๆ ใน Microsoft Graph ได้หลายรูปแบบ เช่น การแสดงรายการ, การสร้าง, การอัปเดต, การคัดลอก, การย้ายและการลบโฟลเดอร์ ตัวอย่างต่อไปนี้เป็นสถานการณ์ทั่วไป

List Folders

ตัวอย่างต่อไปนี้ดึงโฟลเดอร์ทั้งหมดและพิมพ์ชื่อที่แสดงพร้อมคุณสมบัติต่าง ๆ ของมัน:

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

List Subfolders from Inbox Folder

คุณยังสามารถแสดงรายการซับโฟลเดอร์ภายใต้โฟลเดอร์เฉพาะ เช่น Inbox:

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

Create Folders

คุณสามารถสร้างโฟลเดอร์ระดับรากและซับโฟลเดอร์ได้

Create a Root Folder

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

Create Subfolders

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างซับโฟลเดอร์ภายในโฟลเดอร์ Inbox:

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

Get Folder

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงโฟลเดอร์เฉพาะ เช่น Sent Items:

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

Update Folder

คุณสามารถอัปเดทคุณสมบัติของโฟลเดอร์ เช่น ชื่อที่แสดง:

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

Copy Folder and Its Content

ตัวอย่างต่อไปนี้แสดงวิธีคัดลอกโฟลเดอร์พร้อมซับโฟลเดอร์และข้อความ:

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

Move Folder and Its Content

คุณยังสามารถย้ายโฟลเดอร์พร้อมเนื้อหาทั้งหมดไปยังตำแหน่งอื่นได้:

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

Delete Folder

ใช้ตัวอย่างโค้ดต่อไปนี้เพื่อลบโฟลเดอร์อย่างถาวร:

client.delete(testFolder.getItemId());

Java: วิธีใช้ GraphClient สำหรับ Microsoft Graph

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

ทำงานกับ GraphClient

อินสแตนซ์ของ IGraphClient คลาสนี้จัดการการสร้างคำร้อง ส่งไปยัง Microsoft Graph API และประมวลผลการตอบกลับ

สร้างอ็อบเจ็กต์ ITokenProvider

เพื่อสร้างอินสแตนซ์ใหม่ของ IGraphClient คลาส คุณจำเป็นต้องให้ตัวอย่างของ ITokenProvider, ซึ่งสามารถรับรองคำขอไปยัง Microsoft Graph.

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Gets oAuth access token.
        // If ignoreExistingToken is true, requests new token from a server. Otherwise behavior is depended on whether token exists or not.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Gets oAuth access token.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return new OAuthToken("token", expirationDate);
    }
};

รับอ็อบเจ็กต์ GraphClient

หลังจากที่คุณตั้งค่า TokenProvider แล้ว คุณต้องรับ IGraphClient อ็อบเจ็กต์เพื่อทำคำร้องต่อบริการ หลังจากที่คุณมี IGraphClient เมื่อมีการตรวจสอบสิทธิ์แล้ว คุณสามารถเริ่มทำการเรียกใช้บริการได้

IGraphClient client = GraphClient.getClient(tokenProvider);

ทำงานกับโฟลเดอร์โดยใช้ Microsoft Graph

List Folders

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

List Subfolders from Inbox Folder

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

สร้างโฟลเดอร์ราก

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

สร้างโฟลเดอร์ย่อย

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

Get Folder

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

Update Folder

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

คัดลอกโฟลเดอร์และเนื้อหา

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

ย้ายโฟลเดอร์และเนื้อหา

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

Delete Folder

client.delete(testFolder.getItemId());

แสดงรายการข้อความด้วย Microsoft Graph

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

แสดงรายการข้อความตามวันที่ส่ง

นี้ OrderBy ฟีเจอร์นี้ใช้เพื่อบ่งบอกว่าข้อความควรเรียงตามลำดับจากน้อยไปมากตามวันที่ส่ง ซึ่งทำให้คลไอเอนต์สามารถดึงรายการข้อความจาก GraphKnownFolders.Inbox โฟลเดอร์ตามลำดับที่กำหนดในกรณีนี้คือตามวันที่ส่ง.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างคำสอบถามที่ระบุการเรียงข้อความตามวันที่ส่ง แล้วใช้คำสอบถามนี้เพื่อดึงหน้าของข้อความจากโฟลเดอร์ Inbox ด้วย Graph API:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

ดึงข้อความ

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

การแบ่งหน้าในรายการข้อความ

API ให้การสนับสนุนการแบ่งหน้าและการกรองสำหรับการแสดงรายการข้อความ ซึ่งมีประโยชน์อย่างยิ่งเมื่อกล่องจดหมายมีจำนวนข้อความมากและต้องใช้เวลานานในการดึงข้อมูลสรุปเกี่ยวกับมัน ตัวอย่างโค้ดด้านล่างจะแสดงวิธีใช้การแบ่งหน้าสำหรับชุดข้อความขนาดใหญ่เมื่อแสดงรายการข้อความจาก Exchange Server ผ่าน IGraphClient:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

สร้างข้อความ

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

อัปเดตข้อความ

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

ส่งข้อความ

client.send(message);

ส่งข้อความร่าง

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

คัดลอกข้อความ

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

ย้ายข้อความ

MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

ไฟล์แนบของข้อความ

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

ลบข้อความ

client.delete(message.getItemId());

Categories Api

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;
OutlookCategory category = client.createCategory(categoryName, preset);
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

List<OutlookCategory> categories = client.listCategories();

fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

client.delete(category.getId());

Overrides Api

int focusedType = ClassificationType.Focused;
ClassificationOverride override = client.createOrUpdateOverride(new MailAddress("testUser@host.com", "testUser"), focusedType);

List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");

ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

client.delete(updatedOverride.getId());

Rules Api

InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients().addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());

createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

client.delete(createdRule.getRuleId());

การใช้ Resource เพื่อรองรับหลายกล่องจดหมาย

сlient.setResource(ResourceType.Users);
сlient.setResourceId("mailbox");
сlient.listMessages("mailfolder")
// back to the current mailbox
сlient.setResource(ResourceType.Me);