Documentation – کار با Microsoft Graph Client

Java: راه‌اندازی Azure AD و احراز هویت Microsoft Graph - Aspose.Email برای جاوا

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

Aspose.Email for Java یک ادغام کامل با Microsoft Graph فراهم می‌کند که به توسعه‌دهندگان امکان مدیریت پیام‌ها، مخاطبان، تقویم‌ها و کارها از حساب‌های Microsoft 365 را می‌دهد. این راهنما شما را در ایجاد یک برنامه Azure AD و پیکربندی احراز هویت برای شروع برنامه‌نویسی با Aspose.Email راهنمایی می‌کند GraphClient.

قبل از استفاده از APIهای Microsoft Graph با Aspose.Email، باید یک برنامه در Azure Active Directory (Azure AD) ثبت کنید و احراز هویت را پیکربندی کنید. این صفحه شامل موارد زیر است:

ایجاد یک برنامه Azure AD (پروژه).
اختصاص مجوزهای لازم Microsoft Graph.
تولید اعتبارها (client ID، client secret، tenant ID).
احراز هویت در Java با استفاده از ارائه‌دهندگان توکن Aspose.Email.

پس از اتمام، آماده تعامل با Microsoft Graph از برنامه Java خود خواهید بود.

۱. ایجاد برنامه Azure AD

این مراحل را برای ثبت برنامه خود در پرتال Azure دنبال کنید:

وارد شوید به پرتال Azure.
به Azure Active Directory → App Registrations → New Registration بروید.

یک Name برای برنامه خود وارد کنید (مثلاً AsposeEmailGraphApp).
انواع حساب‌های پشتیبانی‌شده را انتخاب کنید:
- تک‌مستاجری (اگر فقط سازمان شما از آن استفاده می‌کند)
- چند‑مستاجری (اگر چندین سازمان نیاز به دسترسی دارند)
به‌صورت اختیاری، یک Redirect URI تنظیم کنید (برای احراز هویت تعاملی یا وب لازم است).
روی Register کلیک کنید.

۲. ایجاد Client Secret

پس از ثبت، به Certificates & Secrets → New Client Secret بروید.
توضیح و دوره انقضا را اضافه کنید.

مقدار secret تولید‌شده را کپی کنید - دیگر قابل مشاهده نخواهد بود.

client secret را ایمن نگه دارید؛ برای احراز هویت کلاینت محرمانه ضروری است.

باید صفحه برنامه‌های تازه ثبت‌شده را ببینید.

۳. پیکربندی مجوزهای Microsoft Graph

به API Permissions → Add a Permission → Microsoft Graph بروید.
نوع مجوزها را انتخاب کنید: Delegated یا Application، بسته به وضعیت شما.
مجوزهای مورد نیاز برای عملیات Aspose.Email را اضافه کنید:
- Contacts.ReadWrite – برای مدیریت مخاطبان
- Calendars.ReadWrite – برای مدیریت تقویم‌ها
- Mail.ReadWrite – برای خواندن و ارسال پیام‌ها
- Tasks.ReadWrite – برای مدیریت کارها
در صورت نیاز، روی Grant Admin Consent کلیک کنید.

۴. اجازه دادن به جریان‌های کلاینت عمومی

مشخص کنید آیا برنامه یک کلاینت عمومی است یا نه. مناسب برای برنامه‌هایی که از جریان‌های اعطای توکن استفاده می‌کنند و نیاز به URI هدایت ندارند.

۵. احراز هویت Microsoft Graph

روش‌های احراز هویت پشتیبانی‌شده در Aspose.Email

احراز هویت با استفاده از یک کلاینت محرمانه

از AzureConfidentialTokenProvider برای احراز هویت زمانی که client ID, client secret, and 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 از طریق IGraphClient رابط. برای احراز درخواست‌ها، یک پیاده‌سازی از ITokenProvider ضروری است. در حالی که اکثر توسعه‌دهندگان از ارائه‌دهندگان احراز هویت پیش‌ساخته استفاده می‌کنند، مواردی وجود دارد که ممکن است بخواهید ارائه‌دهنده خود را ایجاد کنید، برای مثال هنگام کار با جریان Resource Owner Password Credentials (ROPC).

۱. پیاده‌سازی ITokenProvider با استفاده از AzureROPCTokenProvider

این کلاس پیاده‌سازی‌ای از ITokenProvider با استفاده از جریان Azure Resource Owner Password Credentials (ROPC). مثال زیر فقط برای مقاصد نمایشی است. در محیط تولید، توصیه می‌کنیم از جریان‌های امن‌تری مانند اعتبارنامه‌های مشتری یا کد مجوز همراه با 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();
    }
}

۲. ایجاد یک شی 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);
    }
};

۳. استفاده از ارائه‌دهنده توکن سفارشی

زمانی که 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 در Aspose.Email برای جاوا

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

Aspose.Email for Java یک ادغام قابل اطمینان با Microsoft Graph فراهم می‌کند، که به توسعه‌دهندگان امکان دسترسی و مدیریت داده‌های صندوق پستی از جمله پیام‌ها، پوشه‌ها، مخاطبان، تقویم‌ها و وظایف را می‌دهد. با استفاده از IGraphClient از طریق API می‌توانید احراز هویت کنید، کوئری بزنید و عملیات روی حساب‌های Microsoft 365 را مستقیماً از برنامه‌های جاوای خود انجام دهید.

بخش‌های زیر جنبه‌های مختلف کار با Microsoft Graph در Aspose.Email برای جاوا را پوشش می‌دهند:

احراز هویت با Microsoft Graph

استفاده از کوئری‌های OData در Microsoft Graph

مدیریت مخاطبان Microsoft Graph

مدیریت تقویم‌های Microsoft Graph

مدیریت وظایف Microsoft Graph

هر صفحه شامل توضیحات مفصل، روش‌های API موجود، و مثال‌های کد است.

Java: ویژگی‌های ابزار Microsoft Graph

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

ایجاد پروژه در مرکز مدیریت Azure Active Directory

یک پروژه باید در مرکز مدیریت Azure Active Directory برای کاربری با حساب MS Office ایجاد شود.

مراحل ایجاد یک پروژه در مرکز مدیریت Azure Active Directory

در ادامه یک آموزش گام به گام برای ایجاد یک پروژه در مرکز مدیریت Azure Active Directory آمده است.

۱. به Azure Active Directory بروید و با استفاده از اعتبارهای MS Office خود وارد شوید.

Azure Active Directory لینک - https://aad.portal.azure.com/

۲. ایجاد برنامه Azure AD در مستاجر شما.

در پنل سمت چپ، برچسب Azure Active Directory را کلیک کنید. این کار صفحه Azure Active Directory را باز می‌کند. در آن صفحه باید برچسب App registrations را ببینید. این نقطه شروع ثبت یک برنامه Azure AD است. این صفحه به شما امکان ایجاد برنامه جدید برای Azure AD را می‌دهد.

روی دکمه New registration کلیک کنید تا برنامه جدیدی ایجاد کنید.

۳. اکنون صفحه ثبت برنامه جدید را مشاهده خواهید کرد.

Name این نام برنامه شما خواهد بود.
Supported account types این بخش دسترسی را محدود خواهد کرد.

دکمه Register را کلیک کنید.

۴. باید صفحه برنامه‌های تازه ثبت‌شده را ببینید.

Application (client) ID شناسه برنامه شما.
Directory (tenant) ID شناسه مستاجر Azure AD.

۵. اجازه دادن به مجوزها برای Microsoft Graph API.

روی برچسب API permissions کلیک کنید.

Azure قبلاً به برنامه شما مجوزهای تفویض‌شده User.Read را اعطا کرده است. این مجوز به ما اجازه می‌دهد اطلاعات کاربر وارد شده را بخوانیم. این‌ها مجوزهای Microsoft Graph API هستند، که می‌توان آن‌ها را 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 کلیک کنید.

۶. اجازه دادن به جریان‌های کلاینت عمومی.

مشخص می‌کند آیا برنامه یک کلاینت عمومی است یا نه. مناسب برای برنامه‌هایی که از جریان‌های اعطای توکن استفاده می‌کنند و نیاز به URI هدایت ندارند.

۷. ایجاد یک کلید برای برنامه

کلاس‌های کمکی

کلاس‌های کمکی زیر برای اجرای کدها در این بخش ضروری هستند. این کلاس‌ها صرفاً برای ساده‌سازی نمایش استفاده می‌شوند.

کلاس AzureROPCTokenProvider

یک نمونه از IGraphClient کلاس ساختن درخواست‌ها، ارسال آن‌ها به API Microsoft Graph و پردازش پاسخ‌ها را مدیریت می‌کند. برای ایجاد یک نمونه جدید از این کلاس، باید یک نمونه از 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

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

Aspose.Email برای جاوا به شما امکان انجام انواع عملیات پوشه در Microsoft Graph را می‌دهد، مانند لیست کردن، ایجاد، به‌روزرسانی، کپی، انتقال و حذف پوشه‌ها. در زیر مثال‌هایی از سناریوهای رایج آورده شده است.

لیست پوشه‌ها

مثال زیر تمام پوشه‌ها را بازیابی می‌کند و نام‌های نمایشی آن‌ها را همراه با ویژگی‌هایشان چاپ می‌کند:

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

لیست زیرپوشه‌ها از پوشه Inbox

همچنین می‌توانید زیرپوشه‌های یک پوشه خاص، مانند Inbox، را لیست کنید:

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

ایجاد پوشه‌ها

می‌توانید هم پوشه‌های ریشه‌ای و هم زیرپوشه‌ها را ایجاد کنید.

ایجاد پوشه ریشه

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

ایجاد زیرپوشه‌ها

نمونه کد زیر نشان می‌دهد چگونه یک زیرپوشه زیر پوشه Inbox ایجاد کنید:

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

دریافت پوشه

نمونه کد زیر نشان می‌دهد چگونه یک پوشه خاص، مانند Sent Items، را بازیابی کنید:

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

به‌روزرسانی پوشه

می‌توانید ویژگی‌های پوشه را به‌روزرسانی کنید، به عنوان مثال، نام نمایشی آن:

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

حذف پوشه

از نمونه کد زیر برای حذف دائمی یک پوشه استفاده کنید:

client.delete(testFolder.getItemId());

Java: کار با پیام‌ها با استفاده از Microsoft Graph

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

Aspose.Email for Java مجموعه‌ای غنی از APIها را برای مدیریت پیام‌ها از طریق Microsoft Graph فراهم می‌کند. می‌توانید پیام‌ها را لیست، دریافت، ایجاد، به‌روزرسانی، جابجا، کپی و حذف کنید، همچنین می‌توانید صفحه‌بندی و پیوست‌ها را مدیریت کنید. نمونه‌های کد زیر مثال‌هایی از رایج‌ترین عملیات هستند.

لیست پیام‌ها

می‌توانید پیام‌ها را از یک پوشه خاص، مانند صندوق ورودی، بازیابی کنید و محتوای کامل آنها را دریافت کنید:

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

یا پس از ساخت یک پیش‌نویس در پوشه پیش‌نویس‌ها، پیام پیش‌نویس را ارسال کنید:

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

ارجاع به راه‌اندازی Azure AD و احراز هویت Microsoft Graph مقاله‌ای برای یادگیری نحوه یکپارچه‌سازی برنامه شما با Microsoft Graph.

Aspose.Email for Java پشتیبانی برای مدیریت موارد تقویم از طریق Microsoft Graph ارائه می‌دهد. می‌توانید تقویم‌ها را فهرست کنید، با رویدادهای تقویم کار کنید و موارد را با یا بدون تنظیمات به‌روزرسانی به‌روز کنید.

نمونه کد زیر نشان می‌دهد چگونه موارد تقویم را با استفاده از روش‌های زیر از GraphClient کلاس:

listCalendars() — مجموعه‌ای از تقویم‌های قابل دسترس را بازیابی می‌کند.
listCalendarItems(String id) — موارد تقویم را برای یک تقویم خاص بازیابی می‌کند.
fetchCalendarItem(String 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

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

علاوه بر کار با پیام‌ها، پوشه‌ها و پیوست‌ها، Aspose.Email برای جاوا همچنین به شما امکان مدیریت ویژگی‌های سطح صندوق پستی مانند دسته‌ها، Overrideهای صندوق متمرکز و قوانین را می‌دهد. همچنین می‌توانید با سوئیچ کردن زمینه منبع، با چندین صندوق پستی کار کنید. این عملیات‌ها از طریق ادغام Graph API در دسترس هستند.

نحوه کار با دسته‌های Outlook

دسته‌بندی‌ها در 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

Overrideها تعیین می‌کنند پیام‌های ارسال‌کنندگان خاص در پوشه 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 گراف امکان ایجاد، دریافت، به‌روزرسانی، لیست و حذف قوانین اینباکس را فراهم می‌کند.

// 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 برای جاوا پشتیبانی از کوئری‌های OData را هنگام کار با Microsoft Graph فراهم می‌کند. این امکان را می‌دهد تا فیلترهای پیشرفته، ترتیب‌بندی، انتخاب، صفحه‌بندی و گسترش را هنگام دریافت منابعی مانند پوشه‌ها، پیام‌ها، مخاطبان و آیتم‌های تقویم اعمال کنید. ODataQueryBuilder کلاس به شما اجازه می‌دهد پارامترهای کوئری OData را به‌صورت ساختارمند و قابل‌استفاده مجدد بسازید به‌جای ساخت دستی رشته‌های کوئری. متدهای زیر می‌توانند برای شمارش و جستجو در مجموعه‌های داده بزرگ اعمال شوند:

Select برای دریافت فقط ویژگی‌هایی که نیاز دارید.
Filter برای اعمال فیلترها.
OrderBy برای مرتب‌سازی نتایج.
Top و Skip برای صفحه‌بندی.
Expand برای گسترش موجودیت‌های مرتبط در یک کوئری.

چندین GraphClient متدها یک پارامتر اختیاری می‌پذیرند 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

Aspose.Email for Java پشتیبانی برای مدیریت کارها از طریق Microsoft Graph ارائه می‌دهد. می‌توانید فهرست‌های کار را شمارش، ایجاد یا حذف کنید و کارها را با گزینه‌های به‌روز‌رسانی انعطاف‌پذیر مدیریت کنید.

نمونه کد زیر نشان می‌دهد چگونه فهرست‌های کار و کارها را با استفاده از روش‌های زیر از GraphClient کلاس:

listTaskLists() — تمام فهرست‌های کار را بازیابی می‌کند.
getTaskList(String id) — یک فهرست کار خاص را بازیابی می‌کند.
deleteTaskList(String id) — یک فهرست کار را حذف می‌کند.
listTasks(String id) — کارها را برای یک فهرست کار مشخص بازیابی می‌کند.
fetchTask(String 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 با Aspose.Email for Java

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

Aspose.Email for Java پشتیبانی برای مدیریت مخاطبین از طریق Microsoft Graph ارائه می‌دهد. می‌توانید مخاطبین را مستقیماً از پوشه‌های مخاطب فهرست، دریافت، ایجاد و به‌روزرسانی کنید.

نمونه کد زیر نشان می‌دهد چگونه موارد مخاطب را با استفاده از روش‌های زیر کتابخانه مدیریت کنید:

listContacts(String id) — مجموعه‌ای از مخاطبین را از پوشه تعیین‌شده بازیابی می‌کند.
fetchContact(String 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: نحوه استفاده از 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

لیست پوشه‌ها

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

لیست زیرپوشه‌ها از پوشه Inbox

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

دریافت پوشه

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

به‌روزرسانی پوشه

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

حذف پوشه

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

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

API Overrides

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

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