Documentation – Microsoft Graph 클라이언트 사용

Net: Azure Active Directory 관리 센터에서 프로젝트 만들기

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

MS Office 계정을 가진 사용자를 위해 Azure Active Directory 관리 센터에서 프로젝트를 생성합니다.

Azure Active Directory 관리 센터에서 프로젝트 만들기 단계

아래는 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 애플리케이션 ID.
Directory (tenant) ID Azure AD 테넌트 ID.

5. Microsoft Graph API에 대한 권한 허용

API permissions 레이블을 클릭하십시오.

Azure는 이미 애플리케이션에 User.Read 위임 권한을 부여했습니다. 이 권한을 통해 로그인한 사용자의 정보를 읽을 수 있습니다. 이는 Microsoft Graph API 권한이며, 범위(Scopes) 라고도 부를 수 있습니다.

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 Graph를 이용한 Microsoft 365 데이터 접근 및 관리

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

Aspose.Email Graph Client로 Microsoft 365 데이터 접근 및 관리 최적화

Microsoft Graph Microsoft 365 데이터를 액세스하기 위한 REST API입니다. Aspose.Email for .NET의 Graph Client 구현을 통해 우리의 API에서 Microsoft Graph에 접근할 수 있습니다. 아래 예제에서는 토큰을 제공하여 MS Graph Client 인스턴스를 생성합니다. 그런 다음 폴더를 관리하고 업데이트, 복사, 삭제하는 주요 메서드를 살펴봅니다. 메시지와 그 내용 및 첨부 파일도 MS Graph Client를 사용해 액세스하거나 변경할 수 있습니다. 카테고리, 규칙, 노트북 및 오버라이드를 관리하는 기능은 Aspose.Email이 제공하는 Microsoft Graph Client의 확장 기능입니다.

MSAL을 사용하여 .NET에서 IGraphClient 인증 및 요청

Microsoft Graph 서비스와 상호 작용하려면, 를 생성해야 합니다. IGraphClient 객체. 인증이 완료되면 이 클라이언트를 사용하여 다양한 서비스 요청을 할 수 있습니다. 해당 GetClient 메서드는, 를 생성합니다 IGraphClient, 필요합니다 ITokenProvider 구현을 첫 번째 매개변수로 사용합니다. 이 ITokenProvider 필요한 인증 토큰을 제공하는 역할을 합니다. 토큰을 얻기 위해 우리는 Microsoft 인증 라이브러리 (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 속성. 다음 코드 샘플은 폴더 목록을 조회하고 메시지를 검색하기 위해 GCC High 엔드포인트에 연결하도록 GraphClient를 구성하는 방법을 보여줍니다.

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를 입력으로 받습니다. 삭제 해당 메서드는 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를 사용한 메시지 관리

.NET용 Aspose.Email에 구현된 MS Graph Client는 메시지와 첨부 파일을 관리하기 위한 다양한 메서드를 제공합니다:

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

Graph 클라이언트를 이용한 Outlook 항목 관리

캘린더 이벤트 관리

Aspose.Email는 캘린더 이벤트에 접근, 관리 및 상호 작용하기 위한 API를 제공합니다. 이를 위해 다음 메서드를 제공합니다: IGraphClient 인터페이스:

ListCalendars() - 캘린더 정보 컬렉션을 검색합니다.
ListCalendarItems(string id) - 지정된 캘린더 ID와 연결된 캘린더 항목 컬렉션을 검색합니다.
FetchCalendarItem(string id) - 제공된 ID를 기반으로 특정 캘린더 항목을 검색합니다.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - 지정된 캘린더에 새 캘린더 항목을 생성합니다.
UpdateCalendarItem(MapiCalendar mapiCalendar) - 기존 캘린더 항목을 업데이트합니다.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - 지정된 업데이트 설정으로 기존 캘린더 항목을 업데이트합니다.

다음 코드 샘플은 Aspose.Email에서 제공하는 메서드를 사용하여 Microsoft Graph API 클라이언트에서 캘린더 이벤트와 상호 작용하는 방법을 보여줍니다:


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

카테고리 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 카테고리를 관리하려면 다음 메서드를 사용하십시오:

// 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) - 지정된 폴더 ID와 연결된 MAPI 연락처 컬렉션을 검색합니다.
FetchContact(string id) - 제공된 항목 ID를 기반으로 특정 연락처를 검색합니다.
CreateContact(string folderId, MapiContact contact) - 지정된 폴더에 새 연락처를 생성합니다.
UpdateContact(MapiContact contact) - 기존 연락처를 업데이트합니다.

다음 코드 샘플은 Aspose.Email에서 제공하는 메서드를 사용하여 Microsoft Graph API 클라이언트에서 연락처와 상호 작용하는 방법을 보여줍니다:

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

오버라이드 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 오버라이드를 관리하려면 다음 메서드를 사용하십시오:

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

규칙 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 규칙을 관리하려면 다음 메서드를 사용하십시오:

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

노트북 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 노트북을 관리하려면 다음 메서드를 사용하십시오:

// 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) - 제공된 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: MSAL을 이용한 Microsoft Graph 인증 (Aspose.Email)

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

Graph 인증 소개

Microsoft Graph Outlook, OneDrive, Teams 등 Microsoft 365 서비스 전반의 데이터를 액세스하기 위한 통합 REST API입니다. Aspose.Email for .NET은 내장된 IGraphClient 고수준의 강력하게 타입이 지정된 API를 제공하여 Microsoft Graph와의 상호작용을 단순화하는 인터페이스.

사용 IGraphClient, MSAL을 통해 인증한 후 다음과 같은 일반 작업을 수행할 수 있습니다:

메일 폴더 관리 (목록, 생성, 업데이트, 복사, 삭제)
메시지 및 첨부 파일 작업 (읽기, 보내기, 이동 및 내용 조작)
캘린더 이벤트, 연락처, 카테고리, 규칙, 작업 및 OneNote 노트북에 접근하고 관리하기

다음 예제는 생성 및 구성 방법을 보여줍니다 GraphClient 액세스 토큰이 포함된 인스턴스이며, 그 뒤에 일반적인 사용 시나리오가 이어집니다.

MSAL.NET으로 Microsoft Graph 인증

Aspose.Email for .NET을 사용하여 Microsoft Graph와 작업하려면 먼저 애플리케이션을 인증해야 합니다. 이는 다음을 구현하여 수행할 수 있습니다. ITokenProvider 인터페이스는 액세스 토큰을 다음에 제공합니다 IGraphClient.

이 섹션에서는 토큰을 얻기 위해 MSAL.NET을 설정하고 초기화하는 방법을 안내합니다. IGraphClient Microsoft Graph 서비스에 인증된 요청을 보내기 위해.

Microsoft 인증 라이브러리 (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 인스턴스. Microsoft Graph와 상호 작용을 시작하려면 리소스 유형과 ID를 설정하십시오.

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

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

IGraphClient가 이제 인증되었으며 애플리케이션을 대신하여 Microsoft Graph에 요청을 보낼 준비가 되었습니다.

Microsoft Graph에서 GCC High 엔드포인트에 연결

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 클라이언트를 초기화할 수 있는 메서드입니다. 다음 코드 샘플은 Azure AD 애플리케이션 자격 증명을 사용하여 인증된 Microsoft Graph 클라이언트를 구성하고 특정 사용자의 사서함에서 작업할 수 있도록 하는 방법을 보여줍니다:

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를 사용하여 폴더를 생성, 나열, 업데이트, 복사, 이동 및 삭제하는 메서드를 제공합니다.

폴더 목록

다음 사용 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를 사용한 비동기 메시지 목록

다음 코드 샘플은 Inbox 폴더에 접근하고, 다음을 사용하여 이메일 메시지 한 페이지를 가져오는 방법을 보여줍니다 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() Inbox에서 최대 10개의 메시지를 가져오려면, 다음 쿼리를 사용합니다 builder.GetQuery().
- 조회된 메시지를 messages 변수에 저장합니다.
오름차순
- 다음 호출로 정렬 순서를 오름차순으로 설정합니다. builder.SentDate.OrderBy(true).
- 사용 client.ListMessages() 다시 Inbox에서 메시지를 가져오되, 이번에는 오름차순으로.
- 이 메시지들을 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);
}

메시지 가져오기

특정 메시지의 전체 내용을 가져옵니다. 다음 코드 샘플은 Inbox에서 최신 메시지를 조회하고 표시하거나 처리하는 방법을 보여줍니다:

호출하십시오 client.ListFolders() 메일함의 모든 사용 가능한 폴더를 가져와 folders 변수에 저장합니다.
foreach 루프를 사용하여 폴더 컬렉션의 각 폴더를 순회합니다.
루프 내부에서 폴더 표시 이름이 "Inbox"인지 확인합니다.
폴더가 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);
        }
        
    }
}

OData를 활용한 Microsoft Graph 쿼리

Aspose.Email for .NET은 Microsoft Graph에 대해 OData 쿼리 지원을 제공합니다. 이를 통해 개발자는 폴더, 메시지, 연락처, 캘린더 항목 등과 같은 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 메서드를 사용하여 새 메시지를 Inbox와 같은 특정 폴더에 직접 저장합니다. 다음 예제는 를 구성하는 방법을 보여줍니다. 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);

초안 메시지 전송

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

첨부 파일 관리

다음은 IGraphClient Aspose.Email for .NET에서는 이메일 첨부 파일을 프로그래밍 방식으로 처리할 수 있습니다. 여기에는 메시지와 연결된 첨부 파일을 생성, 조회, 삭제 및 목록화하는 기능이 포함됩니다. 다음 코드 샘플은 Aspose.Email을 사용하여 Microsoft Graph API를 통해 Outlook 메시지에 대한 첨부 파일 전체 생명 주기 관리를 보여줍니다. 필요에 따라 첨부 파일 내용 및 메타데이터를 맞춤 설정할 수 있습니다.


// 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: Aspose.Email Graph 클라이언트를 통한 Outlook 항목 관리

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

캘린더 이벤트 관리

Aspose.Email는 캘린더 이벤트에 접근, 관리 및 상호 작용하기 위한 API를 제공합니다. 이를 위해 다음 메서드를 제공합니다: IGraphClient 인터페이스:

ListCalendars() - 캘린더 정보 컬렉션을 검색합니다.
ListCalendarItems(string id) - 지정된 캘린더 ID와 연결된 캘린더 항목 컬렉션을 검색합니다.
FetchCalendarItem(string id) - 제공된 ID를 기반으로 특정 캘린더 항목을 검색합니다.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - 지정된 캘린더에 새 캘린더 항목을 생성합니다.
UpdateCalendarItem(MapiCalendar mapiCalendar) - 기존 캘린더 항목을 업데이트합니다.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - 지정된 업데이트 설정으로 기존 캘린더 항목을 업데이트합니다.

다음 코드 샘플은 Aspose.Email에서 제공하는 메서드를 사용하여 Microsoft Graph API 클라이언트에서 캘린더 이벤트와 상호 작용하는 방법을 보여줍니다:


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

메시지 카테고리 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 카테고리를 관리하려면 다음 메서드를 사용하고 아래 코드 샘플을 시도하십시오:

// 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) - 지정된 폴더 ID와 연결된 MAPI 연락처 컬렉션을 검색합니다.
FetchContact(string id) - 제공된 항목 ID를 기반으로 특정 연락처를 검색합니다.
CreateContact(string folderId, MapiContact contact) - 지정된 폴더에 새 연락처를 생성합니다.
UpdateContact(MapiContact contact) - 기존 연락처를 업데이트합니다.

다음 코드 샘플은 Aspose.Email에서 제공하는 메서드를 사용하여 Microsoft Graph API 클라이언트에서 연락처와 상호 작용하는 방법을 보여줍니다:

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

오버라이드 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 오버라이드를 관리하려면 다음 메서드를 사용하십시오:

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

받은편지함 규칙 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 규칙을 관리하려면 다음 메서드를 사용하십시오:

// 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 노트북 관리

.NET용 Aspose.Email의 MS Graph를 사용하여 노트북을 관리하려면 다음 메서드를 사용하십시오:

// 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) - 제공된 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);