Documentation – Робота з Microsoft Graph Client

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

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

Проєкт створюється в центрі адміністрування 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 у вашому орендарі

У лівій панелі натисніть мітку 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://learn.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. Створення ключа для застосунку

Net: Аутентифікація Microsoft Graph за допомогою MSAL (Aspose.Email)

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

Вступ до аутентифікації Graph

Microsoft Graph є уніфікованим REST API для доступу до даних у сервісах Microsoft 365, таких як Outlook, OneDrive та Teams. Aspose.Email для .NET надає вбудований IGraphClient інтерфейс, який спрощує взаємодію з Microsoft Graph, пропонуючи високорівневий, типізований API.

Використовуючи IGraphClient, ви можете автентифікуватися через MSAL, а потім виконати типові операції, такі як:

Керування поштовими папками (перелік, створення, оновлення, копіювання, видалення)
Робота з повідомленнями та вкладеннями (читання, надсилання, переміщення та маніпуляція вмістом)
Доступ та керування подіями календаря, контактами, категоріями, правилами, завданнями та блокнотами OneNote

Нижче наведені приклади, які демонструють, як створити та налаштувати GraphClient екземпляр з токеном доступу, після чого слідують типові сценарії використання.

Автентифікація Microsoft Graph за допомогою MSAL.NET

Щоб працювати з Microsoft Graph, використовуючи Aspose.Email для .NET, спочатку потрібно автентифікувати ваш застосунок. Це можна зробити, реалізувавши ITokenProvider інтерфейс, який постачає токени доступу до IGraphClient.

У цьому розділі пояснюється, як налаштувати MSAL.NET для отримання токенів та ініціалізації IGraphClient для надсилання автентифікованих запитів до сервісів Microsoft Graph.

Microsoft Authentication Library (MSAL)

Крок 1: Визначити клас AccessParameters

Створіть простий клас для зберігання ваших облікових даних Microsoft 365 та пов’язаної конфігурації.

public class AccessParameters
{
    public string TenantId { get; init; }
    public string ClientId { get; init; }
    public string ClientSecret { get; init; }
    public string UserId { get; init; }
    public Uri Authority => new ($"https://login.microsoftonline.com/{TenantId}");
    public string ApiUrl => "https://graph.microsoft.com/.default";
}

Крок 2: Встановити пакет MSAL.NET

Додайте Microsoft.Identity.Client пакет NuGet у ваш проект. Він містить Microsoft Authentication Library (MSAL), що використовується для отримання токенів доступу.

dotnet add package Microsoft.Identity.Client

Крок 3: Реалізувати інтерфейс ITokenProvider

Створіть GraphTokenProvider клас, який реалізує ITokenProvider інтерфейс. Цей клас буде використовувати бібліотеку MSAL.NET для отримання токена доступу.

using Microsoft.Identity.Client;
using Microsoft.Identity.Web;
using Aspose.Email.Clients;

public class GraphTokenProvider : ITokenProvider
{
    private readonly IConfidentialClientApplication _app;
    private readonly string[] _scopes;
    private string? _token;

    public GraphTokenProvider(AccessParameters accessParams)
    {
        _app = ConfidentialClientApplicationBuilder.Create(accessParams.ClientId)
            .WithClientSecret(accessParams.ClientSecret)
            .WithAuthority(accessParams.Authority)
            .Build();

        _app.AddInMemoryTokenCache();

        _scopes = new[] { accessParams.ApiUrl };
    }

    public void Dispose()
    {
        throw new NotImplementedException();
    }

    public OAuthToken GetAccessToken()
    {
        return GetAccessToken(false);
    }

    public OAuthToken GetAccessToken(bool ignoreExistingToken)
    {
        if (!ignoreExistingToken && _token != null)
        {
            return new OAuthToken(_token);
        }

        _token = GetAccessTokenAsync().GetAwaiter().GetResult();
        return new OAuthToken(_token);
    }

    private async Task<string?> GetAccessTokenAsync()
    {
        AuthenticationResult? result;

        try
        {
            result = await _app.AcquireTokenForClient(_scopes)
                .ExecuteAsync();

            Console.WriteLine("Token acquired");
        }
        catch (MsalServiceException ex) when (ex.Message.Contains("AADSTS70011"))
        {
            Console.WriteLine("Scope provided is not supported");
            result = null;
        }

        if (result == null) return null;
        _token = result.AccessToken;
        return result.AccessToken;
    }

Крок 4: Створити екземпляр ITokenProvider

Після того, як ваш GraphTokenProvider клас готовий, ви можете створити його екземпляр, використовуючи облікові дані вашого застосунку.

var accessParams = new AccessParameters()
{
    TenantId = "Your Tenant ID",
    ClientId = "Your Client ID",
    ClientSecret = "Your Client Secret",
    UserId = "User's Object ID"
};

var tokenProvider = new GraphTokenProvider(accessParams);

Крок 5: Ініціалізувати IGraphClient

Використайте постачальника токенів для створення автентифікованого IGraphClient екземпляр. Встановіть тип ресурсу та його ID, щоб розпочати взаємодію з Microsoft Graph.

using var client = GraphClient.GetClient(tokenProvider, accessParams.TenantId);

client.Resource = ResourceType.Users;
client.ResourceId = accessParams.UserId;

Ваш IGraphClient тепер автентифікований і готовий надсилати запити до Microsoft Graph від імені вашого застосунку.

Підключення до кінцевої точки GCC High у Microsoft Graph

Aspose.Email GraphClient підтримує підключення до кінцевої точки Microsoft Graph GCC High шляхом встановлення EndPoint властивість вручну. Встановіть властивість у https://graph.microsoft.us перед виконанням запитів.

Нижче наведено приклад коду, який демонструє, як налаштувати GraphClient для підключення до кінцевої точки GCC High з метою переліку папок і отримання повідомлень.

client.EndPoint = "https://graph.microsoft.us";

var folders = client.ListFolders();
string folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgs = client.ListMessages(folderId);

Асинхронна автентифікація до Microsoft Graph

Використайте Aspose.Email.Clients.Graph.IGraphClientAsync інтерфейс для виконання асинхронних операцій з GraphClient. The GraphClient.GetClientAsync(ITokenProvider, string) і GraphClient.GetClientAsync(IMultipleServicesTokenProvider, string) методи дозволяють ініціалізувати асинхронні клієнти Graph. Нижче наведено приклад коду, який демонструє, як налаштувати автентифікований клієнт Microsoft Graph з обліковими даними програми Azure AD, щоб він міг працювати з поштовою скринькою конкретного користувача:

var accessParameters = Settings.User1;

var provider = new AzureConfidentialTokenProvider(
    accessParameters.TenantId,
    accessParameters.ClientId,
    accessParameters.ClientSecret);

var client = GraphClient.GetClientAsync(provider, accessParameters.TenantId);

client.Resource = Aspose.Email.Clients.Graph.ResourceType.Users;
client.ResourceId = accessParameters.Username;
client.EndPoint = "https://graph.microsoft.com";

Net: Доступ до даних Microsoft 365 та управління за допомогою Microsoft Graph

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

Оптимізуйте доступ та управління даними Microsoft 365 за допомогою Aspose.Email Graph Client

Microsoft Graph це REST API для доступу до даних Microsoft 365. Реалізація Graph Client у Aspose.Email для .NET дозволяє доступ до Microsoft Graph з нашого API. У наведених нижче прикладах ми створимо екземпляр MS Graph Client, передаючи токен. Потім розглянемо основні методи управління папками, їх оновлення, копіювання та видалення. Повідомлення, їх вміст та вкладення також можна отримувати або змінювати за допомогою нашого MS Graph Client. Управління категоріями, правилами, блокнотами та перевизначеннями є розширеною функцією Microsoft Graph Client від Aspose.Email.

Автентифікація та запит з IGraphClient за допомогою MSAL у .NET

Щоб взаємодіяти зі службами Microsoft Graph, вам потрібно створити IGraphClient об’єкт. Після автентифікації цей клієнт дозволяє виконувати різні запити сервісу. The GetClient метод, який створює IGraphClient, вимагає ITokenProvider реалізацію як перший параметр. Це ITokenProvider відповідає за надання необхідного токена автентифікації. Щоб отримати токен, ми використаємо Microsoft Authentication Library (MSAL) для .NET.

Ось як налаштувати процес автентифікації:

Крок 1: Налаштування автентифікації

Наступні кроки допоможуть вам отримати токен авторизації:

Створіть клас AccessParameters.

Визначте клас AccessParameters для зберігання ваших облікових даних.

public class AccessParameters
{
    public string TenantId { get; init; }
    public string ClientId { get; init; }
    public string ClientSecret { get; init; }
    public string UserId { get; init; }
    public Uri Authority => new ($"https://login.microsoftonline.com/{TenantId}");
    public string ApiUrl => "https://graph.microsoft.com/.default";
}

Додайте Пакет MSAL.NET.

Встановіть Microsoft.Identity.Client Пакет NuGet, який містить бінарники MSAL.NET, необхідні для аутентифікації.
Реалізуйте інтерфейс ITokenProvider.

Створіть GraphTokenProvider клас, який реалізує ITokenProvider інтерфейс. Цей клас буде використовувати бібліотеку MSAL.NET для отримання токена доступу.

using Microsoft.Identity.Client;
using Microsoft.Identity.Web;
using Aspose.Email.Clients;

public class GraphTokenProvider : ITokenProvider
{
    private readonly IConfidentialClientApplication _app;
    private readonly string[] _scopes;
    private string? _token;

    public GraphTokenProvider(AccessParameters accessParams)
    {
        _app = ConfidentialClientApplicationBuilder.Create(accessParams.ClientId)
            .WithClientSecret(accessParams.ClientSecret)
            .WithAuthority(accessParams.Authority)
            .Build();

        _app.AddInMemoryTokenCache();

        _scopes = new[] { accessParams.ApiUrl };
    }

    public void Dispose()
    {
        throw new NotImplementedException();
    }

    public OAuthToken GetAccessToken()
    {
        return GetAccessToken(false);
    }

    public OAuthToken GetAccessToken(bool ignoreExistingToken)
    {
        if (!ignoreExistingToken && _token != null)
        {
            return new OAuthToken(_token);
        }

        _token = GetAccessTokenAsync().GetAwaiter().GetResult();
        return new OAuthToken(_token);
    }

    private async Task<string?> GetAccessTokenAsync()
    {
        AuthenticationResult? result;

        try
        {
            result = await _app.AcquireTokenForClient(_scopes)
                .ExecuteAsync();

            Console.WriteLine("Token acquired");
        }
        catch (MsalServiceException ex) when (ex.Message.Contains("AADSTS70011"))
        {
            Console.WriteLine("Scope provided is not supported");
            result = null;
        }

        if (result == null) return null;
        _token = result.AccessToken;
        return result.AccessToken;
    }

Крок 2: Створення екземпляру ITokenProvider

Після визначення GraphTokenProvider класу, ви можете створити екземпляр AccessParameters і використайте його для створення екземпляру GraphTokenProvider.

var accessParams = new AccessParameters()
{
    TenantId = "Your Tenant ID",
    ClientId = "Your Client ID",
    ClientSecret = "Your Client Secret",
    UserId = "User's Object ID"
};

var tokenProvider = new GraphTokenProvider(accessParams);

Крок 3: Виконання запитів за допомогою IGraphClient

Нарешті, використайте GraphTokenProvider для створення автентифікованого IGraphClient і починайте робити запити до сервісу.

using var client = GraphClient.GetClient(tokenProvider, accessParams.TenantId);

client.Resource = ResourceType.Users;
client.ResourceId = accessParams.UserId;

Після завершення цих кроків ваш IGraphClient тепер готовий взаємодіяти зі службами Microsoft Graph, використовуючи автентифіковані запити.

Підключення до кінцевих точок GCC High

The GraphClient підтримує підключення до кінцевих точок GCC High за допомогою EndPoint властивість. Нижче наведено приклад коду, який демонструє, як налаштувати GraphClient для підключення до кінцевої точки GCC High для отримання списку папок та повідомлень.

client.EndPoint = "https://graph.microsoft.us";

var folders = client.ListFolders();
string folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgs = client.ListMessages(folderId);

Керування папками за допомогою IGraphClient

Перелік папок

Викликавши ListFolders метод з MS Graph Client, за допомогою якого можна отримати список папок. Кожна папка має набір параметрів, таких як DisplayName, які можна прочитати у FolderInfo тип.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

Оновлення папок

Щоб створити папку за допомогою MS Graph Client, використовуйте CreateFolder метод. Ви отримаєте FolderInfo об’єкт та можливість доступу до DisplayName, ItemId, HasSubFolders та інших властивостей.

var folderInfo = client.CreateFolder("FolderName");
folderInfo.DisplayName = "FolderAnotherName";
client.UpdateFolder(folderInfo);

Копіювання папок

CopyFolder метод є ключовим для копіювання об’єкту папки за допомогою MS Graph.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// copy Folder2 to Folder1
client.CopyFolder(folderInfo1.ItemId, folderInfo2.ItemId);

Переміщення та видалення папок

Використати MoveFolder метод використовується для переміщення папки, приймає newParentId та itemId. Delete метод використовується для видалення елементу за його id.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// move Folder2 to Folder1
client.MoveFolder(folderInfo1.ItemId, folderInfo2.ItemId);
    
// delete Folder1
client.Delete(folderInfo1.ItemId)

Керування повідомленнями за допомогою IGraphClient

MS Graph Client, реалізований в Aspose.Email для .NET, надає набір методів для керування повідомленнями та вкладеннями:

Список повідомлень

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        foreach (var messageInfo in inboxMessages)
        {
            Console.WriteLine(messageInfo.Subject);
        }
    }
}

Фільтрація повідомлень за датою надсилання

The OrderBy метод з колекції бібліотеки дозволяє отримувати повідомлення з різними порядками сортування (за зростанням та спаданням) згідно дати надсилання. Нижче наведено приклад коду, який показує, як сортувати повідомлення за датою надсилання:

IGraphClient client = GraphClient.GetClient(provider, TenantId);

var builder = new GraphQueryBuilder();

// create orderby messages query 'DESC'
builder.SentDate.OrderBy(false);
var messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
var messages = messagePageInfo.Items;

builder.Clear();

// create orderby messages query 'ASC'
builder.SentDate.OrderBy(true);
messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
messages = messagePageInfo.Items;

Перерахування повідомлень з підтримкою посторінкового отримання

API дозволяє здійснювати посторінкове отримання та фільтрацію повідомлень під час їх переліку. Це особливо корисно для поштових скриньок з великим обсягом листів, оскільки економить час, отримуючи лише необхідну зведену інформацію.

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

Спочатку ініціалізуйте клієнт.
Потім встановіть кількість елементів, що відображаються на сторінці, наприклад, 10.
Створіть фільтр, щоб отримувати лише неппрочитані повідомлення, використовуючи GraphQueryBuilder клас. builder.IsRead.Equals(false) встановлює умову для фільтрації неппрочитаних повідомлень.
Викличте ListMessages метод у об’єкті клієнта, який вказує папку (Inbox) та кількість елементів на сторінку (PageInfo(itemsPerPage)) як параметри. Також передається об’єкт запиту для застосування фільтра неппрочитаних повідомлень. Повернений об’єкт PageInfo (pageInfo) містить отримані повідомлення для поточної сторінки у властивості Items.
Створіть цикл, який продовжується, доки не буде досягнута остання сторінка (pageInfo.LastPage має значення false). Отримані повідомлення додаються до існуючого списку повідомлень за допомогою messages.AddRange(pageInfo.Items).

//  reading unread messages with paging
using var client = GraphClient.GetClient(tokenProvider, config.Tenant);

// paging option
var itemsPerPage = 10;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.IsRead.Equals(false);
var query = builder.GetQuery();

// list messages
var pageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(itemsPerPage), query);
var  messages = pageInfo.Items;

while (!pageInfo.LastPage)
{
    pageInfo = client.ListMessages(KnownFolders.Inbox, pageInfo.NextPage, query);
    messages.AddRange(pageInfo.Items);
}

// set messages state as read
foreach (var message in messages)
{
    client.SetRead(message.ItemId);
}

Отримання повідомлень

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        if (inboxMessages.Count > 0)
        {
            // fetch the first message in inbox
            var msg = client.FetchMessage(inboxMessages[0].ItemId);
            
            Console.WriteLine(msg.BodyHtml);
        }
        
    }
}

Створення повідомлень

var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);

// create message in inbox
client.CreateMessage(KnownFolders.Inbox, msg);

Надсилання повідомлень

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// send message
client.Send(msg);

Надсилання чернеток повідомлень

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// add message to Draft folder
var draftMessage = client.CreateMessage(KnownFolders.Drafts, msg);

// send a draft message
client.Send(draftMessage.ItemId);

Надсилання EML‑повідомлень

Створення та надсилання електронних листів просте за допомогою об’єкта MailMessage. Нижче наведено приклад коду, який демонструє, як створити та надіслати електронний лист за допомогою Graph API:

// prepare the message
var eml = new MailMessage
{
    From = "from@domain.com",
    To = "to1@domain.com, to2@domain.com",
    Subject = "New message",
    HtmlBody = "<html><body>This is the HTML body</body></html>"
};

// send the message
graphClient.Send(eml);
graphClient.Create(KnownFolders.Inbox, eml);

Копіювання повідомлень


// copy message to Inbox folder
var copiedMsg = client.CopyMessage(KnownFolders.Inbox, msg.ItemId);

Переміщення повідомлень

// move message to Inbox folder
var movedMsg = client.MoveMessage(KnownFolders.Inbox, msg.ItemId);

Керування вкладеннями


// create an attachment
var attachment = new MapiAttachment();
attachment.SetProperty(KnownPropertyList.DisplayName, "My Attachment");
attachment.SetProperty(KnownPropertyList.AttachDataBinary, new byte[1024]);

// add an attachment to message
var createdAttachment = client.CreateAttachment(messageInfo.ItemId, attachment);

// fetch a message attachment
var fetchedAttachment = client.FetchAttachment(createdAttachment.ItemId);

// delete a message attachment 
client.DeleteAttachment(createdAttachment.ItemId);

// list the message attachments
var attachments = client.ListAttachments(messageInfo.ItemId);

Керування елементами Outlook за допомогою Graph Client

Керування подіями календаря

Aspose.Email надає API для доступу, керування та взаємодії з подіями календаря. Для цих цілей він пропонує наступні методи у IGraphClient interface:

ListCalendars() — Повертає колекцію інформації про календарі.
ListCalendarItems(string id) — Повертає колекцію елементів календаря, пов’язаних з вказаним ідентифікатором календаря.
FetchCalendarItem(string id) — Отримує певний елемент календаря за вказаним ідентифікатором.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) — Створює новий елемент календаря у вказаному календарі.
UpdateCalendarItem(MapiCalendar mapiCalendar) — Оновлює існуючий елемент календаря.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — Оновлює існуючий елемент календаря з вказаними параметрами оновлення.

Нижче наведено приклад коду, який демонструє взаємодію з подіями календаря у клієнті Microsoft Graph API за допомогою методів, наданих Aspose.Email:


// List Calendars
CalendarInfoCollection 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(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

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

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

Керування категоріями

Щоб керувати категоріями за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// create a custom category with Orange color
var category = client.CreateCategory("My custom category", CategoryPreset.Preset1);

// fetch a category
var fetchedCategory = client.FetchCategory(category.Id);

// update category (change color to brown)
fetchedCategory.Preset = CategoryPreset.Preset2;
var updatedCategory = client.UpdateCategory(fetchedCategory);

// list available categories
var categories = client.ListCategories();

foreach (var cat in categories)
{
    Console.WriteLine(cat.DisplayName);
}

// delete a category
client.Delete(fetchedCategory.Id);

Керування контактами

Aspose.Email надає API для доступу, керування та взаємодії з елементами контактів. Для цих цілей він пропонує наступні методи у IGraphClient interface:

ListContacts(string id) — Повертає колекцію MAPI‑контактів, пов’язаних з вказаним ідентифікатором папки.
FetchContact(string id) — Отримує певний контакт за вказаним ідентифікатором елемента.
CreateContact(string folderId, MapiContact contact) — Створює новий контакт у вказаній папці.
UpdateContact(MapiContact contact) — Оновлює існуючий контакт.

Нижче наведено приклад коду, який демонструє взаємодію з контактами у клієнті Microsoft Graph API за допомогою методів, наданих Aspose.Email:

// 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.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

Керування перевизначеннями

Щоб керувати перевизначеннями за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// Create an user's override
var userOverride = client.CreateOrUpdateOverride
    (new MailAddress("JohnBrown@someorg.com", "JohnBrown"), ClassificationType.Focused);

// list the overrides
var overrides = client.ListOverrides();

// update override
userOverride.Sender.DisplayName = "John Brown";
var updatedOverride = client.UpdateOverride(userOverride);

// delete override
client.Delete(updatedOverride.Id);

Керування правилами

Щоб керувати правилами за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// Create a rule
var rule = PrepareRule("user@someorg.com", "User");
var createdRule = client.CreateRule(rule);

// List all rules defined for Inbox
var rules = client.ListRules();

// Fetch a rule
var fetchedRule = client.FetchRule(createdRule.RuleId);

// Update a rule
fetchedRule.DisplayName = "Renamed rule";
fetchedRule.IsEnabled = false;
var updatedRule = client.UpdateRule(createdRule);

// Delete a rule
client.Delete(updatedRule.RuleId);

InboxRule PrepareRule(string email, string displayName)
{
    var rule = new InboxRule()
    {
        DisplayName = "My rule",
        Priority = 1,
        IsEnabled = true,
        Conditions = new RulePredicates(),
        Actions = new RuleActions()
    };

    rule.Conditions.ContainsSenderStrings = new StringCollection { displayName };
    rule.Actions.ForwardToRecipients = new MailAddressCollection
        { new MailAddress(email, displayName, true) };
    rule.Actions.StopProcessingRules = true;

    return rule;
}

Керування блокнотами

Щоб керувати блокнотами за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// create a OneNote notebook
var newNotebook = new Notebook()
{
    DisplayName = "My Notebook"
};
var createdNotebook = client.CreateNotebook(newNotebook);

// fetch a notebook
var fetchedNotebook = client.FetchNotebook(createdNotebook.Id);

// list the notebooks
var notebooks = client.ListNotebooks();

Управління завданнями в Microsoft Graph

Aspose.Email надає розробникам API для доступу, керування та взаємодії зі списками завдань користувачів, використовуючи наступні методи IGraphClient interface:

ListTaskLists() - Отримує колекцію інформації про списки завдань.
GetTaskList(string id) - Отримує конкретний список завдань на основі наданого ідентифікатора.
DeleteTaskList(string id) - Видаляє вказаний список завдань. -ListTasks(string id) - Отримує колекцію завдань, пов’язаних з вказаним ID списку завдань.
FetchTask(string id) - Отримує конкретне завдання за вказаним ID.
CreateTask(MapiTask task, string taskListUri) - Створює нове завдання у вказаному списку завдань.
UpdateTask(MapiTask task) - Оновлює існуюче завдання з наданою інформацією.
UpdateTask(MapiTask task, UpdateSettings updateSettings) - Оновлює існуюче завдання з вказаними параметрами оновлення.

Наступний зразок коду демонструє, як керувати списками завдань:

// List Task Lists
var taskLists = graphClient.ListTaskLists();

foreach (var tList in taskLists)
{
    Console.WriteLine($"Task List: {tList.DisplayName}");
}

// Get Task List
var 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
var newTask = new MapiTask
{
    Subject = "New Task",
    DueDate = new DateTime(2023, 12, 31),
    Status = MapiTaskStatus.NotStarted
};

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

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

// Update Task with UpdateSettings
var updateSettings = new UpdateSettings { SkipAttachments  = true };
MapiTask updatedTaskWithSettings = graphClient.UpdateTask(createdTask, updateSettings);

Net: Управління поштовими текми у Microsoft Graph (Aspose.Email)

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

Aspose.Email IGraphClient інтерфейс, який надає методи для створення, переліку, оновлення, копіювання, переміщення та видалення тек за допомогою Microsoft Graph.

Перелік папок

Використайте ListFolders метод для отримання всіх тек, доступних поточному користувачеві. Кожна тека повертається як FolderInfo об’єкт, який включає властивості, такі як DisplayName, ItemId, HasSubFolders та інші.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

Перелік тек асинхронно

Наступний приклад показує, як отримати всі теки в поштовій скриньці та відобразити їхні назви за допомогою ListFoldersAsync метод.

var folders = await client.ListFoldersAsync();
foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgsPage = await client.ListMessagesAsync(folderId, new PageInfo(15) { PageOffset = 0 }, null);
var msgs = msgsPage.Items;
foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

Створити та оновити теку

Щоб створити нову теку, викличте CreateFolder методу. Це повертає FolderInfo об’єкт, який потім можна змінювати та оновлювати за допомогою UpdateFolder() метод.

var folderInfo = client.CreateFolder("FolderName");
folderInfo.DisplayName = "FolderAnotherName";
client.UpdateFolder(folderInfo);

Копіювати теку

Використайте CopyFolder метод для копіювання теки у нове батьківське розташування. Цей метод вимагає ID батьківської теки‑призначення та ID теки, яка

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// copy Folder2 to Folder1
client.CopyFolder(folderInfo1.ItemId, folderInfo2.ItemId);

Перемістити та видалити теку

Щоб перемістити теку, використайте MoveFolder метод, який приймає newParentId та itemId.
Щоб видалити теку, використайте Delete метод і вкажіть ItemId теки.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// move Folder2 to Folder1
client.MoveFolder(folderInfo1.ItemId, folderInfo2.ItemId);
    
// delete Folder1
client.Delete(folderInfo1.ItemId)

Net: Керуйте електронними листами та вкладеннями за допомогою Microsoft Graph

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

Aspose.Email IGraphClient надає широкий спектр методів для керування електронними повідомленнями та їх вкладеннями через Microsoft Graph.

Доступні операції:

Перелік повідомлень
Фільтрація та посторінкова навігація повідомлень
Отримати вміст повідомлення
Створення та надсилання повідомлень (включаючи чернетки та EML)
Копіювання та переміщення повідомлень
Керування вкладеннями (створення, отримання, видалення, список)

Список повідомлень

Щоб отримати повідомлення з папки, наприклад "Inbox", використайте ListMessages метод.

Отримати список папок за допомогою client.ListFolders().
Пройдіть у циклі по кожній папці.
Перевірте, чи назва папки — "Inbox".
Якщо так, виведіть список повідомлень у вхідних, використовуючи client.ListMessages(folder.ItemId).
Пройдіть у циклі кожне повідомлення у вхідних.
Виведіть тему кожного повідомлення у консоль.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        foreach (var messageInfo in inboxMessages)
        {
            Console.WriteLine(messageInfo.Subject);
        }
    }
}

Асинхронний перелік повідомлень за допомогою Microsoft Graph

Наведений приклад коду демонструє, як отримати доступ до папки Вхідні, отримати сторінку електронних листів з ListMessagesAsync, і виведіть їх теми:

var folders = await client.ListFoldersAsync();
foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgsPage = await client.ListMessagesAsync(folderId, new PageInfo(15) { PageOffset = 0 }, null);
var msgs = msgsPage.Items;
foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

Фільтрація повідомлень за датою надсилання

Ініціалізуйте Graph Client
- Створіть екземпляр IGraphClient за допомогою GraphClient.GetClient() з провайдером та TenantId.
Створити будівельник запитів
- Створіть екземпляр GraphQueryBuilder об’єкт.
Упорядкуйте повідомлення за датою в:

Спадний порядок
- Використати builder.SentDate.OrderBy(false) для встановлення порядку за спаданням.
- Викличте client.ListMessages() для отримання повідомлень з Вхідних з лімітом 10, використовуючи запит з builder.GetQuery().
- Збережіть отримані повідомлення у змінній messages.
Зростаючий порядок
- Встановіть порядок за зростанням, викликавши builder.SentDate.OrderBy(true).
- Використати client.ListMessages() знову для отримання повідомлень з Вхідних, тепер у зростаючому порядку.
- Збережіть ці повідомлення у змінній messages.

IGraphClient client = GraphClient.GetClient(provider, TenantId);

var builder = new GraphQueryBuilder();

// create orderby messages query 'DESC'
builder.SentDate.OrderBy(false);
var messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
var messages = messagePageInfo.Items;

builder.Clear();

// create orderby messages query 'ASC'
builder.SentDate.OrderBy(true);
messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
messages = messagePageInfo.Items;

Перелік повідомлень з пагінацією та фільтруванням

Використовуйте пагінацію під час роботи з великими поштовими скриньками. Нижче наведений приклад отримує непрочитані повідомлення сторінками по 10 і позначає їх як прочитані після обробки:

Ініціалізуйте клієнт.
Встановіть кількість елементів на сторінку, наприклад, 10.
Створіть фільтр, щоб отримувати лише неппрочитані повідомлення, використовуючи GraphQueryBuilder клас. The builder.IsRead.Equals(false) встановлює умову для фільтрування непрочитаних повідомлень.
Викличте ListMessages метод у об’єкті клієнта, який вказує папку (Inbox) та кількість елементів на сторінку (PageInfo(itemsPerPage)) як параметри. Також передається об’єкт запиту для застосування фільтра неппрочитаних повідомлень. Повернений об’єкт PageInfo (pageInfo) містить отримані повідомлення для поточної сторінки у властивості Items.
Створіть цикл, який продовжується, доки не буде досягнута остання сторінка (pageInfo.LastPage — false). Отримані повідомлення додаються до існуючого списку повідомлень за допомогою messages.AddRange(pageInfo.Items).

//  reading unread messages with paging
using var client = GraphClient.GetClient(tokenProvider, config.Tenant);

// paging option
var itemsPerPage = 10;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.IsRead.Equals(false);
var query = builder.GetQuery();

// list messages
var pageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(itemsPerPage), query);
var  messages = pageInfo.Items;

while (!pageInfo.LastPage)
{
    pageInfo = client.ListMessages(KnownFolders.Inbox, pageInfo.NextPage, query);
    messages.AddRange(pageInfo.Items);
}

// set messages state as read
foreach (var message in messages)
{
    client.SetRead(message.ItemId);
}

Отримати повідомлення

Отримайте повний вміст конкретного повідомлення. Наведений приклад коду демонструє, як отримати та відобразити останнє повідомлення у Вхідних для перегляду або обробки:

Викличте client.ListFolders() для отримання всіх доступних папок у поштовій скриньці та збереження їх у змінній folders.
Ітерація по кожній папці в колекції папок за допомогою циклу foreach.
Всередині циклу перевірте, чи назва папки дорівнює "Inbox".
Якщо папка — це Вхідні, отримайте повідомлення за допомогою client.ListMessages() з ItemId папки.
Перевірте, чи є повідомлення у вхідних, переконавшись, що inboxMessages.Count більше 0.
Якщо є повідомлення, отримайте перший лист за допомогою client.FetchMessage() з першим ItemId повідомлення.
Виведіть HTML-тіло отриманого повідомлення.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        if (inboxMessages.Count > 0)
        {
            // fetch the first message in inbox
            var msg = client.FetchMessage(inboxMessages[0].ItemId);
            
            Console.WriteLine(msg.BodyHtml);
        }
        
    }
}

Запити Microsoft Graph з OData

Aspose.Email для .NET забезпечує підтримку OData запитів для Microsoft Graph. Це дозволяє розробникам застосовувати розширене фільтрування, сортування, вибір, пагінацію та розширення при роботі з ресурсами Graph, такими як папки, повідомлення, контакти, елементи календаря тощо. Aspose.Email.Clients.Graph.ODataQueryBuilder клас створений для побудови параметрів запиту OData у структурований спосіб замість ручного складання рядків запиту. Так ви можете отримати лише необхідні поля (Select) для ефективності, використовуйте фільтрацію (Filter) та сортування (OrderBy) для організації даних. Ви також можете реалізувати пагінацію (Top, Skip) для великих наборів даних, розширити пов’язані сутності (Expand) в одному виклику, а також дозволяє підрахунок і повнотекстовий пошук для розширених сценаріїв.

Нижче наведено список GraphClient методи, що підтримують необов’язковий ODataQueryBuilder параметр:

ListFolders
ListMessages
ListContacts
ListCalendarItems
ListAttachments
ListCategories
ListOverrides
ListRules
ListTaskLists
ListTasks
ListNotebooks

Наведений приклад коду демонструє, як використовувати ODataQueryBuilder для переліку папок і отримання відфільтрованих, відсортованих та розбитих на сторінки електронних повідомлень з поштової скриньки:

var accessParameters = Settings.User1;

var provider = new AzureConfidentialTokenProvider(
    accessParameters.TenantId,
    accessParameters.ClientId,
    accessParameters.ClientSecret);

var client = GraphClient.GetClient(provider, accessParameters.TenantId);

client.Resource = Aspose.Email.Clients.Graph.ResourceType.Users;
client.ResourceId = accessParameters.Username;
client.EndPoint = "https://graph.microsoft.com";

// Example 1: List folders ordered by name
var builder = new ODataQueryBuilder { OrderBy = "name asc" };
var folders = client.ListFolders(builder);

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

// Example 2: Retrieve filtered and paged messages from Inbox
var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;

builder = new ODataQueryBuilder
{
    Filter = "startswith(name,'A')",
    OrderBy = "name asc",
    Top = 10,
    Skip = 5,
    Select = new[] { "name", "age" },
    Expand = new[] { "children", "parents" },
    Count = true,
    Search = "\"John Doe\"",
    Format = "json"
};

var msgs = client.ListMessages(folderId, builder);

foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

Створити повідомлення

Використайте CreateMessage метод для безпосереднього збереження нового повідомлення у конкретну папку, наприклад, Вхідні. Наведений приклад демонструє, як побудувати MapiMessage і додати його до поштової скриньки.

var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);

// create message in inbox
client.CreateMessage(KnownFolders.Inbox, msg);

Надсилання повідомлень

The Надіслати метод IGraphClient дозволяє вам надсилати електронне повідомлення безпосередньо, використовуючи MapiMessage об’єкт. У цьому прикладі створюється просте повідомлення, налаштовується з деталями відправника та одержувача, і потім надсилається.

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// send message
client.Send(msg);

Надіслати чернетку

Ви можете зберегти повідомлення у папці Drafts і надіслати його пізніше, використовуючи IGraphClient. Цей підхід дозволяє підготувати повідомлення, переглянути або змінити його перед відправленням, а потім надіслати, коли воно готове. Наведений приклад коду демонструє, як створити електронний лист, додати метадані, зберегти його як чернетку, а потім надіслати:

Створіть MapiMessage з темою, вмістом і одержувачами.
Встановіть дані відправника, використовуючи властивості повідомлення.
Збережіть повідомлення у папці Drafts, використовуючи CreateMessage.
Надішліть чернетку, передавши її ItemId до Send() метод.

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// add message to Draft folder
var draftMessage = client.CreateMessage(KnownFolders.Drafts, msg);

// send a draft message
client.Send(draftMessage.ItemId);

Надіслати повідомлення EML

Використайте MailMessage клас для створення та надсилання повідомлень у форматі EML. Наведений приклад коду демонструє, як створити та надіслати електронний лист за допомогою Graph API:

// prepare the message
var eml = new MailMessage
{
    From = "from@domain.com",
    To = "to1@domain.com, to2@domain.com",
    Subject = "New message",
    HtmlBody = "<html><body>This is the HTML body</body></html>"
};

// send the message
graphClient.Send(eml);
graphClient.Create(KnownFolders.Inbox, eml);

Копіювання повідомлень

Щоб створити копію існуючого повідомлення електронної пошти, використайте CopyMessage метод IGraphClient інтерфейсу.


// copy message to Inbox folder
var copiedMsg = client.CopyMessage(KnownFolders.Inbox, msg.ItemId);

Переміщення повідомлень

Щоб перемістити існуюче повідомлення електронної пошти з його поточного розташування до нової папки, використайте MoveMessage метод IGraphClient інтерфейсу.

// move message to Inbox folder
var movedMsg = client.MoveMessage(KnownFolders.Inbox, msg.ItemId);

Керування вкладеннями

The IGraphClient у Aspose.Email для .NET дозволяє програмно працювати з вкладеннями електронної пошти. Це включає створення, отримання, видалення та перелік вкладень, пов’язаних із повідомленням. Наведений приклад коду демонструє повне управління життєвим циклом вкладень для повідомлень Outlook через Microsoft Graph API з використанням Aspose.Email. Ви можете налаштувати вміст та метадані вкладення за потреби.


// create an attachment
var attachment = new MapiAttachment();
attachment.SetProperty(KnownPropertyList.DisplayName, "My Attachment");
attachment.SetProperty(KnownPropertyList.AttachDataBinary, new byte[1024]);

// add an attachment to message
var createdAttachment = client.CreateAttachment(messageInfo.ItemId, attachment);

// fetch a message attachment
var fetchedAttachment = client.FetchAttachment(createdAttachment.ItemId);

// delete a message attachment 
client.DeleteAttachment(createdAttachment.ItemId);

// list the message attachments
var attachments = client.ListAttachments(messageInfo.ItemId);

Net: Управління елементами Outlook за допомогою Aspose.Email Graph Client

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

Керування подіями календаря

ListCalendars() — Повертає колекцію інформації про календарі.
ListCalendarItems(string id) — Повертає колекцію елементів календаря, пов’язаних з вказаним ідентифікатором календаря.
FetchCalendarItem(string id) — Отримує певний елемент календаря за вказаним ідентифікатором.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) — Створює новий елемент календаря у вказаному календарі.
UpdateCalendarItem(MapiCalendar mapiCalendar) — Оновлює існуючий елемент календаря.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — Оновлює існуючий елемент календаря з вказаними параметрами оновлення.


// List Calendars
CalendarInfoCollection 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(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

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

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

Керування категоріями повідомлень

Щоб керувати категоріями за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи та спробуйте наведенний нижче приклад коду:

// create a custom category with Orange color
var category = client.CreateCategory("My custom category", CategoryPreset.Preset1);

// fetch a category
var fetchedCategory = client.FetchCategory(category.Id);

// update category (change color to brown)
fetchedCategory.Preset = CategoryPreset.Preset2;
var updatedCategory = client.UpdateCategory(fetchedCategory);

// list available categories
var categories = client.ListCategories();

foreach (var cat in categories)
{
    Console.WriteLine(cat.DisplayName);
}

// delete a category
client.Delete(fetchedCategory.Id);

Керування контактами

ListContacts(string id) — Повертає колекцію MAPI‑контактів, пов’язаних з вказаним ідентифікатором папки.
FetchContact(string id) — Отримує певний контакт за вказаним ідентифікатором елемента.
CreateContact(string folderId, MapiContact contact) — Створює новий контакт у вказаній папці.
UpdateContact(MapiContact contact) — Оновлює існуючий контакт.

// 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.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

Керування перевизначеннями

Щоб керувати перевизначеннями за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// Create an user's override
var userOverride = client.CreateOrUpdateOverride
    (new MailAddress("JohnBrown@someorg.com", "JohnBrown"), ClassificationType.Focused);

// list the overrides
var overrides = client.ListOverrides();

// update override
userOverride.Sender.DisplayName = "John Brown";
var updatedOverride = client.UpdateOverride(userOverride);

// delete override
client.Delete(updatedOverride.Id);

Керування правилами вхідних повідомлень

Щоб керувати правилами за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// Create a rule
var rule = PrepareRule("user@someorg.com", "User");
var createdRule = client.CreateRule(rule);

// List all rules defined for Inbox
var rules = client.ListRules();

// Fetch a rule
var fetchedRule = client.FetchRule(createdRule.RuleId);

// Update a rule
fetchedRule.DisplayName = "Renamed rule";
fetchedRule.IsEnabled = false;
var updatedRule = client.UpdateRule(createdRule);

// Delete a rule
client.Delete(updatedRule.RuleId);

InboxRule PrepareRule(string email, string displayName)
{
    var rule = new InboxRule()
    {
        DisplayName = "My rule",
        Priority = 1,
        IsEnabled = true,
        Conditions = new RulePredicates(),
        Actions = new RuleActions()
    };

    rule.Conditions.ContainsSenderStrings = new StringCollection { displayName };
    rule.Actions.ForwardToRecipients = new MailAddressCollection
        { new MailAddress(email, displayName, true) };
    rule.Actions.StopProcessingRules = true;

    return rule;
}

Управління блокнотами OneNote

Щоб керувати блокнотами за допомогою MS Graph від Aspose.Email для .NET, використовуйте наступні методи:

// create a OneNote notebook
var newNotebook = new Notebook()
{
    DisplayName = "My Notebook"
};
var createdNotebook = client.CreateNotebook(newNotebook);

// fetch a notebook
var fetchedNotebook = client.FetchNotebook(createdNotebook.Id);

// list the notebooks
var notebooks = client.ListNotebooks();

Керування завданнями в Microsoft Graph

ListTaskLists() - Отримує колекцію інформації про списки завдань.
GetTaskList(string id) - Отримує конкретний список завдань на основі наданого ідентифікатора.
DeleteTaskList(string id) - Видаляє вказаний список завдань. -ListTasks(string id) - Отримує колекцію завдань, пов’язаних з вказаним ID списку завдань.
FetchTask(string id) - Отримує конкретне завдання за вказаним ID.
CreateTask(MapiTask task, string taskListUri) - Створює нове завдання у вказаному списку завдань.
UpdateTask(MapiTask task) - Оновлює існуюче завдання з наданою інформацією.
UpdateTask(MapiTask task, UpdateSettings updateSettings) - Оновлює існуюче завдання з вказаними параметрами оновлення.

Наступний зразок коду демонструє, як керувати списками завдань:

// List Task Lists
var taskLists = graphClient.ListTaskLists();

foreach (var tList in taskLists)
{
    Console.WriteLine($"Task List: {tList.DisplayName}");
}

// Get Task List
var 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
var newTask = new MapiTask
{
    Subject = "New Task",
    DueDate = new DateTime(2023, 12, 31),
    Status = MapiTaskStatus.NotStarted
};

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

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

// Update Task with UpdateSettings
var updateSettings = new UpdateSettings { SkipAttachments  = true };
MapiTask updatedTaskWithSettings = graphClient.UpdateTask(createdTask, updateSettings);