Documentation – Работа с Microsoft Graph клиент

Net: Създаване на проект в Azure Active Directory Admin Center

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

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

Стъпки за създаване на проект в администраторския център на Azure Active Directory

По-долу е стъпка по стъпка ръководство за създаване на проект в Azure Active Directory admin center.

1. Отидете в Azure Active Directory и влезте, използвайки вашите MS Office идентификационни данни

Azure Active Directory Връзка - https://aad.portal.azure.com/

2. Създайте Azure AD приложение във вашия tenant

В лявото странично меню кликнете върху етикета Azure Active Directory. Това ще отвори панела за Azure Active Directory. На този екран трябва да видите етикет App registrations. Това е отправната точка за регистриране на Azure AD приложение. Този панел ще ви позволи да създадете ново приложение за Azure AD.

Кликнете върху бутона New registration, за да създадете ново приложение.

3. Сега ще видите панела за регистрация на ново приложение

Name Това ще бъде името на вашето приложение.
Supported account types Този раздел ще ограничи достъпа.

Кликнете бутона Register.

4. Трябва да видите панела с ново регистрирани приложения

Application (client) ID ID на вашето приложение.
Directory (tenant) ID ID на Azure AD тенанта.

5. Позволяване на разрешения за Microsoft Graph API

Кликнете върху етикета API permissions.

Azure вече ви е предоставил делегирани права User.Read за вашето приложение. Това разрешение ще ни позволи да четем информация за потребителя, който е влязъл. Това са разрешения за Microsoft Graph API, които можем също да наричаме Scopes.

Пълният списък със scope‑ове за Microsoft Graph API - https://learn.microsoft.com/en-us/graph/permissions-reference.

Кликнете бутона + Add a permission и изберете Microsoft Graph.

Кликнете върху Delegated permissions. Сега виждате списък с разрешения, достъпни за Microsoft Graph API.

Изберете необходимите разрешения, кликнете бутона Add permissions.

Кликнете бутона Grant admin consent.

6. Позволяване на потоци от публични клиенти

Посочва дали приложението е публичен клиент. Подходящо за приложения, използващи потоци за предоставяне на токени, които не използват пренасочващ URI.

7. Създаване на ключ за приложението

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 обект. След като се автентифицирате, този клиент ви позволява да правите различни заявки към услуги. Този 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 крайни точки

Този 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

List Folders

С извикване на 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. Изтриване метод се използва за изтриване на метод по 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, предоставя набор от методи за управление на съобщения и прикачени файлове:

List съобщения
Fetch съобщение
Create съобщение
Изпрати съобщение
CopyMessage съобщение
Move съобщение
CreateAttachment
FetchAttachment
DeleteAttachment
ListAttachments

Списък на съобщения

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

Филтриране на съобщения по дата на изпращане

Този 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 клиент

Управление на календарни събития

Aspose.Email предлага API за достъп, управление и взаимодействие с календарни събития. За тези цели предоставя следните методи в IGraphClient интерфейс:

ListCalendars() – Извлича колекция от информация за календари.
ListCalendarItems(string id) – Извлича колекция от календарни елементи, свързани с указаното 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 интерфейс:

ListContacts(string id) – Извлича колекция от MAPI контакти, свързани с указаното ID на папка.
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);

Управление на override

За управление на override с 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 интерфейс:

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 с 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 Graph (Aspose.Email)

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

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

List Folders

Използвайте 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.
За да изтриете папка, използвайте Изтриване метод и предоставете 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)
Копиране и преместване на съобщения
Управлявайте прикачени файлове (създаване, извличане, изтриване, изброяване)

List съобщения
Fetch съобщение
Create съобщение
Изпрати съобщение
CopyMessage съобщение
Move съобщение
CreateAttachment
FetchAttachment
DeleteAttachment
ListAttachments

Списък на съобщения

За извличане на съобщения от папка, като "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.
Създайте Query Builder
- Инстанцирайте 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 клас. Този 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);

Изпращане на съобщения

Този Изпрати метод на 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);

Изпратете чернова

Можете да запазите съобщение в папка Чернови и да го изпратите по-късно, използвайки IGraphClient. Този подход ви позволява да подготвите съобщение, да го прегледате или промените преди изпращане и след това да го изпратите, когато е готово. Следният примерен код демонстрира как да създадете имейл, добавите метаданни, да го съхраните като чернова и след това да го изпратите:

Създайте MapiMessage с тема, тяло и получатели.
Задайте данни за подател, използвайки свойства на съобщението.
Запазете съобщението в папка Чернови, използвайки 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);

Управление на прикачени файлове

Този 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 клиент

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

Управление на календарни събития

ListCalendars() – Извлича колекция от информация за календари.
ListCalendarItems(string id) – Извлича колекция от календарни елементи, свързани с указаното 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 контакти, свързани с указаното ID на папка.
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);

Управление на override

За управление на override с 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);