Documentation – کار با Microsoft Graph Client

Net: ایجاد یک پروژه در مرکز مدیریت Azure Active Directory

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

یک پروژه باید در مرکز مدیریت Azure Active Directory برای کاربری با حساب MS Office ایجاد شود.

مراحل ایجاد یک پروژه در مرکز مدیریت Azure Active Directory

در ادامه یک آموزش گام به گام برای ایجاد یک پروژه در مرکز مدیریت Azure Active Directory ارائه شده است.

۱. به Azure Active Directory بروید و با استفاده از اعتبارهای MS Office خود وارد شوید

Azure Active Directory لینک - https://aad.portal.azure.com/

۲. ایجاد یک برنامه Azure AD در مستأجر خود

در نوار سمت چپ، برچسب Azure Active Directory را کلیک کنید. این کار صفحه‌ای برای Azure Active Directory باز می‌کند. در آن صفحه باید برچسب App registrations را ببینید. این نقطه شروع ثبت یک برنامه Azure AD است. این صفحه به شما امکان ایجاد یک برنامه جدید برای Azure AD را می‌دهد.

روی دکمه New registration کلیک کنید تا برنامه جدیدی ایجاد کنید.

۳. اکنون صفحه ثبت برنامه جدید را خواهید دید

Name این نام برنامه شما خواهد بود.
Supported account types این بخش دسترسی را محدود خواهد کرد.

دکمه Register را کلیک کنید.

۴. باید صفحه برنامه‌های تازه ثبت‌شده را ببینید

Application (client) ID شناسه برنامه شما.
Directory (tenant) ID شناسه مستاجر Azure AD.

۵. اعطای دسترسی‌ها برای Microsoft Graph API

روی برچسب API permissions کلیک کنید.

Azure قبلاً به برنامه شما دسترسی‌های واگذار شده User.Read را اعطا کرده است. این دسترسی به ما امکان خواندن اطلاعات کاربر وارد شده را می‌دهد. این‌ها دسترسی‌های Microsoft Graph API هستند که می‌توانیم آن‌ها را Scopes نیز بنامیم.

لیست کامل محدوده‌ها (scopes) برای Microsoft Graph API - https://learn.microsoft.com/en-us/graph/permissions-reference.

روی دکمه + Add a permission کلیک کنید و Microsoft Graph را انتخاب کنید.

روی Delegated permissions کلیک کنید. اکنون فهرستی از مجوزهای موجود برای Microsoft Graph API را می‌بینید.

مجوزهای مورد نیاز را انتخاب کنید، روی دکمه Add permissions کلیک کنید.

روی دکمه Grant admin consent کلیک کنید.

۶. اجازه به جریان‌های کلاینت عمومی

مشخص می‌کند آیا برنامه یک کلاینت عمومی است یا نه. مناسب برای برنامه‌هایی که از جریان‌های اعطای توکن استفاده می‌کنند و نیاز به URI هدایت ندارند.

۷. ایجاد یک کلید برای برنامه

Net: احراز هویت Microsoft Graph با MSAL (Aspose.Email)

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

مقدمه‌ای بر احراز هویت Graph

Microsoft Graph یک API یکپارچه REST برای دسترسی به داده‌های سرویس‌های Microsoft 365 مانند Outlook، OneDrive و Teams است. Aspose.Email برای .NET یک IGraphClient رابطی که تعامل با Microsoft Graph را با ارائه API سطح بالا و نوع‌دار ساده می‌کند.

استفاده از IGraphClient، می‌توانید با MSAL احراز هویت کنید، سپس عملیات‌های عمومی مانند زیر را انجام دهید:

مدیریت پوشه‌های ایمیل (فهرست، ایجاد، به‌روزرسانی، کپی، حذف)
کار با پیام‌ها و پیوست‌ها (خواندن، ارسال، جابه‌جایی و دستکاری محتوا)
دسترسی و مدیریت رویدادهای تقویم، مخاطبان، دسته‌بندی‌ها، قوانین، کارها و دفترچه‌های OneNote

مثال‌های زیر نشان می‌دهند چگونه یک GraphClient نمونه با یک توکن دسترسی، سپس سناریوهای استفاده معمول.

احراز هویت Microsoft Graph با MSAL.NET

برای کار با Microsoft Graph با استفاده از Aspose.Email برای .NET، ابتدا باید برنامه خود را احراز هویت کنید. این کار با پیاده‌سازی ITokenProvider رابط که توکن‌های دسترسی را به IGraphClient.

این بخش شما را در راه‌اندازی MSAL.NET برای دریافت توکن‌ها و مقداردهی اولیه IGraphClient برای ارسال درخواست‌های احراز هویت‌شده به خدمات Microsoft Graph.

کتابخانه احراز هویت مایکروسافت (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 به پروژه شما. شامل کتابخانه احراز هویت مایکروسافت (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 تعامل را آغاز کنید.

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 از اتصال به نقطه انتهایی GCC High Microsoft Graph با تنظیم 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 365 با Microsoft Graph

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

بهینه‌سازی دسترسی و مدیریت داده‌های Microsoft 365 با Aspose.Email Graph Client

Microsoft Graph یک API REST برای دسترسی به داده‌های 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 مسئول ارائه توکن احراز هویت مورد نیاز است. برای دریافت توکن، ما از کتابخانه احراز هویت مایکروسافت (MSAL) برای .NET.

نحوه تنظیم فرآیند احراز هویت به این شکل است:

مرحله ۱: تنظیم احراز هویت

مراحل زیر به شما نشان می‌دهد چگونه یک توکن احراز هویت دریافت کنید:

ایجاد کلاس 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;
    }

مرحله ۲: ایجاد یک نمونه 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);

مرحله ۳: ارسال درخواست‌ها با 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

لیست پوشه‌ها

با فراخوانی 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 را می‌پذیرد. حذف این متد برای حذف یک متد بر اساس شناسه استفاده می‌شود.

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

مدیریت پیام‌ها با IGraphClient

MS Graph Client که در Aspose.Email برای .NET پیاده‌سازی شده، مجموعه‌ای از متدها برای مدیریت پیام‌ها و پیوست‌ها ارائه می‌دهد:

لیست پیام‌ها

var folders = client.ListFolders();

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

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

فیلتر کردن پیام‌ها بر حسب تاریخ ارسال

این 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 با استفاده از ویژگی‌های صفحه‌بندی و فیلتر بازیابی کنید.

ابتدا، کلاینت را مقداردهی اولیه کنید.
سپس، تعداد آیتم‌های نمایش داده‌شده در هر صفحه را تنظیم کنید، برای مثال ۱۰.
یک فیلتر ایجاد کنید تا فقط پیام‌های نخوانده را با استفاده از GraphQueryBuilder کلاس. builder.IsRead.Equals(false) شرط فیلتر کردن پیام‌های نخوانده را تنظیم می‌کند.
متد را فراخوانی کنید ListMessages متد بر روی شیء کلاینت، پوشه (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) - مجموعه‌ای از آیتم‌های تقویم مرتبط با شناسه تقویم مشخص‌شده را بازیابی می‌کند.
FetchCalendarItem(string id) - یک آیتم تقویم خاص را بر اساس شناسه ارائه‌شده بازیابی می‌کند.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - یک آیتم تقویم جدید در تقویم مشخص‌شده ایجاد می‌کند.
UpdateCalendarItem(MapiCalendar mapiCalendar) - یک آیتم تقویم موجود را به‌روز می‌کند.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - یک آیتم تقویم موجود را با تنظیمات به‌روزرسانی مشخص به‌روز می‌کند.

نمونه کد زیر نشان می‌دهد چگونه می‌توان با رویدادهای تقویم در یک کلاینت Microsoft Graph API با استفاده از روش‌های ارائه‌شده توسط Aspose.Email تعامل کرد:


// List Calendars
CalendarInfoCollection calendars = graphClient.ListCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.ListCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.FetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

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

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

مدیریت دسته‌بندها

برای مدیریت دسته‌بندها با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

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

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

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

مدیریت مخاطبان

Aspose.Email APIهایی را برای دسترسی، مدیریت و تعامل با آیتم‌های مخاطب فراهم می‌کند. برای این منظور، روش‌های زیر را در IGraphClient رابط:

ListContacts(string id) - مجموعه‌ای از مخاطبان MAPI مرتبط با شناسه پوشه مشخص‌شده را بازیابی می‌کند.
FetchContact(string id) - یک مخاطب خاص را بر اساس شناسه آیتم ارائه‌شده بازیابی می‌کند.
CreateContact(string folderId, MapiContact contact) - یک مخاطب جدید در پوشه مشخص‌شده ایجاد می‌کند.
UpdateContact(MapiContact contact) - یک مخاطب موجود را به‌روزرسانی می‌کند.

نمونه کد زیر نشان می‌دهد چگونه می‌توان با مخاطبان در یک کلاینت Microsoft Graph API با استفاده از روش‌های ارائه‌شده توسط Aspose.Email تعامل کرد:

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

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

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

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

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

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

مدیریت نادیده‌گیری‌ها

برای مدیریت نادیده‌گیری‌ها (overrides) با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

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

مدیریت قوانین

برای مدیریت قوانین با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

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

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

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

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

    return rule;
}

مدیریت دفترچه‌ها

برای مدیریت دفترچه‌ها با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

مدیریت وظایف در Microsoft Graph

Aspose.Email به توسعه‌دهندگان APIهایی برای دسترسی، مدیریت و تعامل با وظایف و فهرست‌های وظیفه کاربران ارائه می‌دهد با استفاده از متدهای زیر IGraphClient رابط:

ListTaskLists() - مجموعه‌ای از اطلاعات فهرست‌های کار را بازیابی می‌کند.
GetTaskList(string id) - فهرست کار خاصی را بر اساس شناسه‌ی ارائه‌شده بازیابی می‌کند.
DeleteTaskList(string id) - فهرست وظیفه مشخص شده را حذف می‌کند. -ListTasks(string id) - مجموعه‌ای از کارها را که با شناسه فهرست کار مشخص مرتبط هستند، بازیابی می‌کند.
FetchTask(string id) - یک کار خاص را بر اساس شناسه ارائه‌شده بازیابی می‌کند.
CreateTask(MapiTask task, string taskListUri) - یک کار جدید را در فهرست کار مشخص‌شده ایجاد می‌کند.
UpdateTask(MapiTask task) - یک کار موجود را با اطلاعات ارائه‌شده به‌روزرسانی می‌کند.
UpdateTask(MapiTask task, UpdateSettings updateSettings) - یک کار موجود را با تنظیمات به‌روزرسانی مشخص به‌روزرسانی می‌کند.

نمونه کد زیر نشان می‌دهد چگونه فهرست‌های وظیفه را مدیریت کنید:

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

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

// Get Task List
var taskList = graphClient.GetTaskList("taskListId");

// Delete Task List
graphClient.DeleteTaskList("taskListId");

نمونه کد زیر نشان می‌دهد چگونه وظایف را مدیریت کنید:

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.ListTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.FetchTask("taskId");

// Create Task
var newTask = new MapiTask
{
    Subject = "New Task",
    DueDate = new DateTime(2023, 12, 31),
    Status = MapiTaskStatus.NotStarted
};

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

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

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

Net: مدیریت پوشه‌های ایمیل در Microsoft Graph (Aspose.Email)

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

Aspose.Email IGraphClient رابطی که متدهایی برای ایجاد، فهرست، به‌روزرسانی، کپی، جابه‌جایی و حذف پوشه‌ها با استفاده از Microsoft Graph فراهم می‌کند.

لیست پوشه‌ها

از ListFolders متد برای دریافت تمام پوشه‌های موجود برای کاربر فعلی. هر پوشه به صورت یک FolderInfo شیئی که شامل ویژگی‌هایی مانند DisplayName، ItemId، HasSubFolders و موارد دیگر است.

var folders = client.ListFolders();

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

فهرست کردن پوشه‌ها به‌صورت ناهمزمان

مثال زیر نشان می‌دهد چگونه تمام پوشه‌های یک صندوق پست را دریافت کرده و نام‌های آن‌ها را با استفاده از ListFoldersAsync متد.

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

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

ایجاد و به‌روزرسانی یک پوشه

برای ایجاد یک پوشه جدید، فراخوانی کنید CreateFolder متد. این متد یک FolderInfo شیئی که سپس می‌توان با استفاده از UpdateFolder() متد.

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

کپی یک پوشه

از CopyFolder متد برای کپی کردن یک پوشه به مکان والد جدید. این متد نیاز به شناسه پوشه والد مقصد و شناسه پوشه‌ای که کپی می‌شود دارد.

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)
کپی و جابه‌جایی پیام‌ها
مدیریت پیوست‌ها (ایجاد، بازیابی، حذف، فهرست‌بندی)

لیست پیام‌ها

برای دریافت پیام‌ها از یک پوشه مانند "صندوق ورودی"، از ListMessages متد.

دریافت فهرست پوشه‌ها با استفاده از client.ListFolders().
در هر پوشه حلقه بزنید.
بررسی کنید آیا نام نمایشی پوشه "Inbox" است.
اگر این‌طور است، پیام‌های اینباکس را با استفاده از client.ListMessages(folder.ItemId).
در هر پیام در اینباکس حلقه بزنید.
سرفصل هر پیام را در کنسول چاپ کنید.

var folders = client.ListFolders();

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

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

فهرست کردن پیام‌ها به صورت آسنکرون با Microsoft Graph

نمونه کد زیر نشان می‌دهد چگونه به پوشه اینباکس دسترسی پیدا کنید، یک صفحه از پیام‌های ایمیل را با ListMessagesAsync، و سرفصل‌های آن‌ها را چاپ کنید:

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

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

فیلتر کردن پیام‌ها بر حسب تاریخ ارسال

مقداردهی اولیه Graph Client
- یک نمونه از IGraphClient با استفاده از GraphClient.GetClient() با provider و TenantId.
ایجاد Query Builder
- یک نمونه از GraphQueryBuilder شیء.
مرتب‌سازی پیام‌ها بر حسب تاریخ در:

ترتیب نزولی
- استفاده کنید builder.SentDate.OrderBy(false) برای تنظیم ترتیب به نزولی.
- فراخوانی کنید client.ListMessages() برای دریافت پیام‌ها از اینباکس با محدودیت ۱۰، با استفاده از پرس و جوی builder.GetQuery().
- پیام‌های بازیابی‌شده را در متغیر messages ذخیره کنید.
ترتیب صعودی
- ترتیب را به صعودی تنظیم کنید با فراخوانی builder.SentDate.OrderBy(true).
- استفاده کنید client.ListMessages() دوباره برای دریافت پیام‌ها از اینباکس، اکنون به ترتیب صعودی.
- این پیام‌ها را در متغیر messages ذخیره کنید.

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

var builder = new GraphQueryBuilder();

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

builder.Clear();

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

فهرست کردن پیام‌ها با صفحه‌بندی و فیلتر کردن

از صفحه‌بندی هنگام کار با صندوق‌های ایمیل بزرگ استفاده کنید. مثال زیر پیام‌های خوانده‌نشده را در صفحات ۱۰ تایی بازیابی می‌کند و پس از پردازش، آن‌ها را به‌عنوان خوانده‌شده نمایش می‌دهد:

کلاینت را راه‌اندازی کنید.
تعداد آیتم‌های نمایش داده‌شده در هر صفحه را تنظیم کنید، برای مثال، ۱۰.
یک فیلتر ایجاد کنید تا فقط پیام‌های نخوانده را با استفاده از GraphQueryBuilder کلاس. builder.IsRead.Equals(false) شرط برای فیلتر کردن پیام‌های خوانده‌نشده را تنظیم می‌کند.
متد را فراخوانی کنید ListMessages متد بر روی شیء کلاینت، پوشه (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);
}

دریافت یک پیام

بازیابی محتوای کامل یک پیام خاص. نمونه کد زیر نشان می‌دهد چگونه آخرین پیام در اینباکس را برای نمایش یا پردازش دریافت و نمایش دهید:

فراخوانی کنید client.ListFolders() برای دریافت تمام پوشه‌های موجود در صندوق ایمیل و ذخیره آن‌ها در متغیر folders.
با استفاده از حلقه foreach روی هر پوشه در مجموعه پوشه‌ها تکرار کنید.
درون حلقه، بررسی کنید آیا نام نمایشی پوشه برابر "Inbox" است.
اگر پوشه InBox باشد، پیام‌ها را با استفاده از client.ListMessages() با ItemId پوشه.
بررسی کنید آیا پیام‌هایی در اینباکس وجود دارد یا نه با تأیید اینکه مقدار inboxMessages.Count بزرگ‌تر از ۰ است.
اگر پیام وجود داشته باشد، اولین پیام را با استفاده از 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);

ارسال یک پیام پیش‌نویس

می‌توانید یک پیام را در پوشه پیش‌نویس‌ها ذخیره کنید و بعداً با استفاده از IGraphClient. این رویکرد به شما امکان می‌دهد یک پیام را آماده کنید، قبل از ارسال بررسی یا اصلاح کنید، و سپس هنگام آماده بودن آن را ارسال کنید. نمونه کد زیر نشان می‌دهد چگونه یک ایمیل ایجاد کنید، متادیتا اضافه کنید، آن را به‌عنوان پیش‌نویس ذخیره کنید و سپس ارسال کنید:

ایجاد یک MapiMessage با موضوع، بدنه و گیرنده‌ها.
جزئیات فرستنده را با استفاده از ویژگی‌های پیام تنظیم کنید.
پیام را با استفاده از CreateMessage.
پیش‌نویس را با ارسال ItemId آن به Send() متد.

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

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

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

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

ارسال یک پیام EML

از MailMessage کلاسی برای ایجاد و ارسال پیام‌های با فرمت EML. نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل را با استفاده از Graph API ایجاد و ارسال کنید:

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

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

کپی پیام‌ها

برای ایجاد یک نسخهٔ تکراری از یک پیام ایمیل موجود، از CopyMessage متد از IGraphClient واسط.


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

انتقال پیام‌ها

برای انتقال یک پیام ایمیل موجود از مکان فعلی آن به یک پوشه جدید، از MoveMessage متد از IGraphClient واسط.

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

مدیریت پیوست‌ها

این IGraphClient در Aspose.Email برای .NET به شما امکان می‌دهد به‌صورت برنامه‌نویسی با پیوست‌های ایمیل کار کنید. این شامل ایجاد، بازیابی، حذف و فهرست‌گذاری پیوست‌های مرتبط با یک پیام می‌شود. نمونه کد زیر مدیریت کامل چرخه‌حیات پیوست برای پیام‌های Outlook از طریق Microsoft Graph API با استفاده از Aspose.Email را نشان می‌دهد. می‌توانید محتوای پیوست و فراداده‌های آن را بر حسب نیاز سفارشی کنید.


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

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

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

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

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

Net: مدیریت آیتم‌های Outlook از طریق Aspose.Email Graph Client

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

مدیریت رویدادهای تقویم

ListCalendars() - مجموعه‌ای از اطلاعات تقویم‌ها را بازیابی می‌کند.
ListCalendarItems(string id) - مجموعه‌ای از آیتم‌های تقویم مرتبط با شناسه تقویم مشخص‌شده را بازیابی می‌کند.
FetchCalendarItem(string id) - یک آیتم تقویم خاص را بر اساس شناسه ارائه‌شده بازیابی می‌کند.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - یک آیتم تقویم جدید در تقویم مشخص‌شده ایجاد می‌کند.
UpdateCalendarItem(MapiCalendar mapiCalendar) - یک آیتم تقویم موجود را به‌روز می‌کند.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - یک آیتم تقویم موجود را با تنظیمات به‌روزرسانی مشخص به‌روز می‌کند.


// List Calendars
CalendarInfoCollection calendars = graphClient.ListCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.ListCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.FetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

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

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

مدیریت دسته‌بندهای پیام

برای مدیریت دسته‌بندها با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید و نمونه کد زیر را امتحان کنید:

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

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

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

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

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

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

مدیریت مخاطبان

ListContacts(string id) - مجموعه‌ای از مخاطبان MAPI مرتبط با شناسه پوشه مشخص‌شده را بازیابی می‌کند.
FetchContact(string id) - یک مخاطب خاص را بر اساس شناسه آیتم ارائه‌شده بازیابی می‌کند.
CreateContact(string folderId, MapiContact contact) - یک مخاطب جدید در پوشه مشخص‌شده ایجاد می‌کند.
UpdateContact(MapiContact contact) - یک مخاطب موجود را به‌روزرسانی می‌کند.

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

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

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

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

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

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

مدیریت نادیده‌گیری‌ها

برای مدیریت نادیده‌گیری‌ها (overrides) با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

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

مدیریت قوانین صندوق ورودی

برای مدیریت قوانین با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

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

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

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

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

    return rule;
}

مدیریت دفترچه‌های OneNote

برای مدیریت دفترچه‌ها با MS Graph توسط Aspose.Email برای .NET، از روش‌های زیر استفاده کنید:

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

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

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

مدیریت وظایف در Microsoft Graph

ListTaskLists() - مجموعه‌ای از اطلاعات فهرست‌های کار را بازیابی می‌کند.
GetTaskList(string id) - فهرست کار خاصی را بر اساس شناسه‌ی ارائه‌شده بازیابی می‌کند.
DeleteTaskList(string id) - فهرست وظیفه مشخص شده را حذف می‌کند. -ListTasks(string id) - مجموعه‌ای از کارها را که با شناسه فهرست کار مشخص مرتبط هستند، بازیابی می‌کند.
FetchTask(string 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);