Documentation – ทำงานกับ Microsoft Graph Client

Net: สร้างโครงการใน Azure Active Directory Admin Center

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

โครงการจะถูกสร้างใน Azure Active Directory admin center สำหรับผู้ใช้ที่มีบัญชี MS Office.

ขั้นตอนการสร้างโครงการใน Azure Active Directory Admin Center

ต่อไปเป็นบทแนะนำทีละขั้นตอนสำหรับการสร้างโครงการใน 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 ของ tenant Azure AD.

5. การอนุญาตสิทธิ์สำหรับ Microsoft Graph API

คลิกที่ป้าย API permissions.

Azure ได้มอบสิทธิ์ delegated User.Read ให้กับแอปพลิเคชันของคุณแล้ว สิทธิ์นี้จะทำให้เราสามารถอ่านข้อมูลผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบได้ สิทธิ์เหล่านี้เป็นสิทธิ์ของ Microsoft Graph API ซึ่งเรายังเรียกอีกอย่างว่า Scopes

รายการเต็มของ scopes สำหรับ Microsoft Graph API - https://learn.microsoft.com/en-us/graph/permissions-reference.

คลิกปุ่ม + Add a permission แล้วเลือก Microsoft Graph.

คลิกที่ Delegated permissions ตอนนี้คุณจะเห็นรายการสิทธิ์ที่มีสำหรับ 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 ที่จำเป็นสำหรับการรับรองตัวตน.
ทำการใช้งาน Interface ITokenProvider

สร้าง GraphTokenProvider คลาสที่ทำการใช้งาน ITokenProvider interface. คลาสนี้จะใช้ไลบรารี 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 มีชุดเมธอดเพื่อจัดการข้อความและไฟล์แนบ:

รายการ ข้อความ
ดึง ข้อความ
สร้าง ข้อความ
ส่ง ข้อความ
คัดลอกข้อความ ข้อความ
ย้าย ข้อความ
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 โดยใช้การแบ่งหน้าและการกรอง.

ขั้นแรก เริ่มต้น client.
จากนั้นตั้งจำนวนรายการต่อหน้าที่จะแสดง เช่น 10.
สร้างตัวกรองเพื่อดึงเฉพาะข้อความที่ยังไม่ได้อ่านโดยใช้ GraphQueryBuilder คลาส บิลเดอร์ .IsRead.Equals(false) ตั้งเงื่อนไขเพื่อกรองข้อความที่ยังไม่ได้อ่าน.
เรียกใช้ ListMessages เมธอดบนอ็อบเจ็กต์ client โดยระบุโฟลเดอร์ (Inbox) และจำนวนรายการต่อหน้า (PageInfo(itemsPerPage)) เป็นพารามิเตอร์ นอกจากนี้ยังส่งอ็อบเจ็กต์ query เพื่อใช้ตัวกรองข้อความที่ยังไม่ได้อ่าน วัตถุ PageInfo ที่ส่งกลับ (pageInfo) มีข้อความที่ดึงมาสำหรับหน้าปัจจุบันในคุณสมบัติ Items.
สร้างลูปที่ทำงานต่อจนกว่าจะถึงหน้าสุดท้าย (pageInfo.LastPage เป็น false) ข้อความที่ดึงมาจะถูกเพิ่มเข้ารายการข้อความที่มีอยู่โดยใช้ messages.AddRange(pageInfo.Items).

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

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

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

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

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

ดึงข้อความ

var folders = client.ListFolders();

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

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

สร้างข้อความ

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

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

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

ส่งข้อความ

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

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

// send message
client.Send(msg);

ส่งข้อความฉบับร่าง

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

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

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

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

ส่งข้อความ EML

การสร้างและส่งอีเมลเป็นเรื่องง่ายโดยใช้วัตถุ MailMessage ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างและส่งข้อความอีเมลโดยใช้ Graph API:

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

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

คัดลอกข้อความ


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

ย้ายข้อความ

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

จัดการไฟล์แนบ


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

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

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

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

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

จัดการรายการ Outlook ด้วย Graph Client

จัดการเหตุการณ์ปฏิทิน

Aspose.Email มี API เพื่อเข้าถึง, จัดการ, และโต้ตอบกับเหตุการณ์ปฏิทิน สำหรับวัตถุประสงค์เหล่านี้ มีเมธอดต่อไปนี้ใน IGraphClient อินเทอร์เฟซ:

ListCalendars() - ดึงคอลเลกชันของข้อมูลปฏิทิน
ListCalendarItems(string id) - ดึงคอลเลกชันของรายการปฏิทินที่เชื่อมโยงกับ ID ปฏิทินที่ระบุ
FetchCalendarItem(string id) - ดึงรายการปฏิทินที่ระบุโดยใช้ 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) - ดึงคอลlection ของผู้ติดต่อ MAPI ที่เชื่อมโยงกับ ID โฟลเดอร์ที่ระบุ
FetchContact(string id) - ดึงข้อมูลผู้ติดต่อที่ระบุโดยใช้ ID ของรายการที่ให้
CreateContact(string folderId, MapiContact contact) - สร้างรายชื่อผู้ติดต่อใหม่ในโฟลเดอร์ที่ระบุ
UpdateContact(MapiContact contact) - อัปเดตรายชื่อผู้ติดต่อที่มีอยู่

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโต้ตอบกับรายชื่อผู้ติดต่อในไคลเอนต์ Microsoft Graph API โดยใช้เมธอดที่ให้โดย Aspose.Email:

// List Contacts
MapiContactCollection contacts = graphClient.ListContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.FetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");

MapiContact createdContact = graphClient.CreateContact("contactFolderId", newContact);

// Update Contact
createdContact.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

จัดการการแทนที่

เพื่อจัดการการแทนที่ด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

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

จัดการกฎ

เพื่อจัดการกฎด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

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

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

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

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

    return rule;
}

จัดการสมุดโน้ต

เพื่อจัดการสมุดโน้ตด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

การจัดการงานใน Microsoft Graph

Aspose.Email ให้ API แก่ผู้พัฒนาเพื่อเข้าถึง, จัดการ, และทำงานกับงานและรายการงานของผู้ใช้โดยใช้เมธอดต่อไปนี้ของ IGraphClient อินเทอร์เฟซ:

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: การตรวจสอบสิทธิ์ 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 for .NET มีในตัว IGraphClient อินเทอร์เฟซที่ทำให้การโต้ตอบกับ Microsoft Graph ง่ายขึ้นโดยให้ API ระดับสูงแบบ strongly-typed.

โดยใช้ IGraphClient, คุณสามารถตรวจสอบสิทธิ์ผ่าน MSAL แล้วทำปฏิบัติการทั่วไปเช่น:

จัดการโฟลเดอร์เมล (แสดงรายการ, สร้าง, อัปเดต, คัดลอก, ลบ)
ทำงานกับข้อความและไฟล์แนบ (อ่าน, ส่ง, ย้าย, และจัดการเนื้อหา)
การเข้าถึงและจัดการเหตุการณ์ปฏิทิน, รายชื่อผู้ติดต่อ, หมวดหมู่, กฎ, งาน, และโน้ตบุ๊ก OneNote

ตัวอย่างต่อไปนี้แสดงวิธีสร้างและกำหนดค่า GraphClient อินสแตนซ์พร้อม access token ตามด้วยสถานการณ์การใช้งานทั่วไป.

ตรวจสอบสิทธิ์ Microsoft Graph ด้วย MSAL.NET

เพื่อทำงานกับ Microsoft Graph โดยใช้ Aspose.Email for .NET คุณต้องตรวจสอบสิทธิ์แอปของคุณก่อน ซึ่งทำได้โดยการ Implement ITokenProvider อินเทอร์เฟซ ซึ่งให้ access token แก่ IGraphClient.

ส่วนนี้จะแนะนำคุณผ่านการตั้งค่า MSAL.NET เพื่อรับ token และการเริ่มต้น 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) ที่ใช้เพื่อรับ access token.

dotnet add package Microsoft.Identity.Client

ขั้นตอนที่ 3: Implement อินเทอร์เฟซ ITokenProvider

สร้าง GraphTokenProvider คลาสที่ทำการใช้งาน ITokenProvider interface. คลาสนี้จะใช้ไลบรารี 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

ใช้ตัวจัดหาตoken เพื่อสร้าง 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. ส่วน 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)
คัดลอกและย้ายข้อความ
จัดการไฟล์แนบ (สร้าง, ดึง, ลบ, รายการ)

รายการ ข้อความ
ดึง ข้อความ
สร้าง ข้อความ
ส่ง ข้อความ
คัดลอกข้อความ ข้อความ
ย้าย ข้อความ
CreateAttachment
FetchAttachment
DeleteAttachment
ListAttachments

แสดงรายการข้อความ

เพื่อดึงข้อความจากโฟลเดอร์เช่น "Inbox" ให้ใช้ ListMessages เมธอด.

ดึงรายการโฟลเดอร์โดยใช้ client.ListFolders().
วนลูปแต่ละโฟลเดอร์.
ตรวจสอบว่าชื่อการแสดงผลของโฟลเดอร์คือ "Inbox"
หากเป็นเช่นนั้น ให้แสดงรายการข้อความใน inbox โดยใช้ client.ListMessages(folder.ItemId).
วนลูปแต่ละข้อความใน inbox.
พิมพ์หัวข้อของแต่ละข้อความไปยังคอนโซล.

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() พร้อมกับ provider และ TenantId.
สร้าง Query Builder
- สร้างอินสแตนซ์ของ 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 เมธอดบนอ็อบเจ็กต์ client โดยระบุโฟลเดอร์ (Inbox) และจำนวนรายการต่อหน้า (PageInfo(itemsPerPage)) เป็นพารามิเตอร์ นอกจากนี้ยังส่งอ็อบเจ็กต์ query เพื่อใช้ตัวกรองข้อความที่ยังไม่ได้อ่าน วัตถุ 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 ของโฟลเดอร์.
ตรวจสอบว่ามีข้อความใดใน inbox หรือไม่โดยตรวจสอบว่า 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 เมธอดเพื่อบันทึกข้อความใหม่โดยตรงลงในโฟลเดอร์เฉพาะ เช่น 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);

คัดลอกข้อความ

เพื่อสร้างสำเนาของข้อความอีเมลที่มีอยู่ ใช้ คัดลอกข้อความ เมธอดของ 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 Client

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

จัดการเหตุการณ์ปฏิทิน

ListCalendars() - ดึงคอลเลกชันของข้อมูลปฏิทิน
ListCalendarItems(string id) - ดึงคอลเลกชันของรายการปฏิทินที่เชื่อมโยงกับ ID ปฏิทินที่ระบุ
FetchCalendarItem(string id) - ดึงรายการปฏิทินที่ระบุโดยใช้ 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) - ดึงคอลlection ของผู้ติดต่อ MAPI ที่เชื่อมโยงกับ ID โฟลเดอร์ที่ระบุ
FetchContact(string id) - ดึงข้อมูลผู้ติดต่อที่ระบุโดยใช้ ID ของรายการที่ให้
CreateContact(string folderId, MapiContact contact) - สร้างรายชื่อผู้ติดต่อใหม่ในโฟลเดอร์ที่ระบุ
UpdateContact(MapiContact contact) - อัปเดตรายชื่อผู้ติดต่อที่มีอยู่

// List Contacts
MapiContactCollection contacts = graphClient.ListContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.FetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");

MapiContact createdContact = graphClient.CreateContact("contactFolderId", newContact);

// Update Contact
createdContact.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

จัดการการแทนที่

เพื่อจัดการการแทนที่ด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

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

จัดการกฎอินบ็อกซ์

เพื่อจัดการกฎด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

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

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

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

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

    return rule;
}

จัดการสมุดโน้ต OneNote

เพื่อจัดการสมุดโน้ตด้วย MS Graph ผ่าน Aspose.Email สำหรับ .NET ให้ใช้เมธอดต่อไปนี้:

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

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

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

จัดการงานใน Microsoft Graph

ListTaskLists() - ดึงคอลเลกชันของข้อมูลรายการงาน.
GetTaskList(string id) - ดึงรายการงานเฉพาะตาม 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);