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.

Перш ніж використовувати 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‑додатку.

1. Створення застосунку Azure AD

Виконайте наступні кроки, щоб зареєструвати ваш застосунок у порталі Azure:

Увійдіть у Портал Azure.
Перейдіть до Azure Active Directory → App Registrations → New Registration.

Введіть Name вашого застосунку (наприклад, AsposeEmailGraphApp).
Виберіть підтримувані типи облікових записів:
- Одноорганізаційний (якщо його буде використовувати лише ваша організація)
- Багатокористувацький (якщо кілька організацій потребують доступу)
За потреби встановіть Redirect URI (потрібно для інтерактивної або веб‑автентифікації).
Натисніть Register.

2. Створення секрету клієнта

Після реєстрації перейдіть до Certificates & Secrets → New Client Secret.
Додайте опис та термін дії.

Скопіюйте згенероване значення секрету – ви більше не зможете його побачити.

Збережіть client secret у безпеці; він потрібен для автентифікації конфіденційного клієнта.

Ви повинні бачити панель новостворених зареєстрованих застосунків.

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

Автентифікація за допомогою конфіденційного клієнта

Використайте 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). Наступний приклад призначений лише для демонстрації. У виробничому середовищі ми рекомендуємо використовувати більш безпечні потоки, такі як облікові дані клієнта або код авторизації з 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

The 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 у 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

Створення проєкту в Azure Active Directory Admin Center

Проєкт створюється в центрі адміністрування Azure Active Directory для користувача з обліковим записом MS Office.

Кроки створення проєкту в Azure Active Directory Admin Center

Нижче наведено покроковий посібник зі створення проєкту в центрі адміністрування Azure Active Directory.

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 Ідентифікатор вашого застосунку.
Directory (tenant) ID Ідентифікатор tenant Azure AD.

5. Надання дозволів для Microsoft Graph API.

Клацніть мітку API permissions.

Azure уже надала вашому застосунку делеговані дозволи User.Read. Цей дозвіл дозволяє читати інформацію про користувача, який увійшов. Це дозволи Microsoft Graph API, інша назва – Scopes.

Повний список областей (scopes) для Microsoft Graph API - https://docs.microsoft.com/en-us/graph/permissions-reference.

Клацніть кнопку + Add a permission і виберіть Microsoft Graph.

Клацніть Delegated permissions. Тепер ви бачите список доступних дозволів для API Microsoft Graph.

Виберіть потрібні дозволи, натисніть кнопку Add permissions.

Натисніть кнопку Grant admin consent.

6. Дозволити потоки публічних клієнтів.

Визначає, чи є застосунок публічним клієнтом. Підходить для додатків, які використовують потоки видачі токенів без redirect URI.

7. Створення ключа для застосунку

Допоміжні класи

Для виконання коду в цьому розділі потрібні наступні допоміжні класи. Ці класи створені лише для спрощення демонстрації.

Клас 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

Див. на Налаштування 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 за допомогою 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: Керування поштовою скринькою за допомогою Microsoft Graph

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

Окрім роботи з повідомленнями, папками та вкладеннями, Aspose.Email for Java також дозволяє керувати функціями рівня скриньки, такими як категорії, перевизначення фокусованої скриньки та правила. Ви також можете працювати з кількома скриньками, переключаючи контекст ресурсу. Ці операції доступні через інтеграцію з 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());

Як працювати з перевизначеннями

Перевизначення керують тим, як повідомлення від певних відправників обробляються у Фокусованій скриньці. Наприклад, можна змусити повідомлення від конкретного відправника завжди відображатися у фокусованій області.

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

Правила скриньки дозволяють автоматизувати дії, такі як пересилання повідомлень або фільтрація за умовами. Graph 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 for Java забезпечує підтримку 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

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

Aspose.Email for Java дозволяє виконувати різноманітні операції з папками в 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());
    }
}

Перелік підпапок у папці Вхідні

Ви також можете перерахувати підпапки в конкретній папці, наприклад, Вхідних:

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

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: Як використовувати 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());
    }
}

Перелік підпапок у папці Вхідні

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

Список повідомлень за датою надсилання

The OrderBy функція використовується, щоб вказати, що повідомлення мають бути впорядковані за зростанням дати надсилання. Це дозволяє клієнту отримати список повідомлень з GraphKnownFolders.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 перевизначень

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

Використання ресурсу для підтримки кількох скриньок

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