مایکروسافت Graph API را برای دسترسی برنامهریزی به خدمات Office 365 و Microsoft Cloud از درون برنامههای شما ارائه میدهد. علاوه بر این، می توانید از Graph API برای مدیریت پوشه ها، ارسال پیام و انجام عملیات های مختلف دیگر استفاده کنید. در این مقاله با نحوه ایجاد و ارسال پیام با استفاده از Microsoft Graph API در سی شارپ آشنا خواهید شد.
- C#.NET Microsoft Graph API برای ایجاد و ارسال پیام
- ایجاد پیام با استفاده از Microsoft Graph API در سی شارپ
- ارسال پیام با استفاده از Microsoft Graph API در سی شارپ
C#.NET Microsoft Graph API برای ایجاد و ارسال پیام
Aspose.Email for .NET یک API شگفت انگیز برای ایجاد و ارسال ایمیل از داخل برنامه های NET است. علاوه بر این، به شما امکان می دهد از Microsoft Graph API استفاده کنید و پوشه ها، پیام ها و غیره را مدیریت کنید. ما از این API برای ایجاد و ارسال پیام با استفاده از Microsoft Graph API استفاده خواهیم کرد. می توانید DLL API را دانلود یا با استفاده از دستور زیر از NuGet نصب کنید.
PM> Install-Package Aspose.Email
ایجاد یک پیام با Microsoft Graph API در سی شارپ
برای برقراری ارتباط با Graph API، ابتدا باید رابط ITokenProvider را برای احراز هویت درخواست ها پیاده سازی کنید. در زیر پیاده سازی اساسی ITokenProvider است.
class AccessTokenProvider : ITokenProvider
{
DateTime expirationDate = DateTime.Now;
public void Dispose()
{
}
public OAuthToken GetAccessToken(bool ignoreExistingToken)
{
// رمز دسترسی oAuth را دریافت می کند.
// اگر ignoreExistingToken درست باشد، توکن جدید را از یک سرور درخواست می کند. در غیر این صورت رفتار بستگی به وجود یا عدم وجود نشانه دارد.
// اگر رمز وجود داشته باشد و تاریخ انقضا آن منقضی نشده باشد، رمز فعلی را برمی گرداند، در غیر این صورت توکن جدید را از یک سرور درخواست می کند.
return null;
}
public OAuthToken GetAccessToken()
{
// رمز دسترسی oAuth را دریافت می کند.
// اگر رمز وجود داشته باشد و تاریخ انقضا آن منقضی نشده باشد، رمز فعلی را برمی گرداند، در غیر این صورت توکن جدید را از یک سرور درخواست می کند.
return new OAuthToken("token", expirationDate);
}
}
در زیر مراحل ایجاد پیام با استفاده از Microsoft Graph API در سی شارپ آمده است.
- ابتدا با استفاده از روش GraphClient.GetClient(ITokenProvider, string) یک نمونه از کلاینت Microsoft Graph دریافت کنید.
- سپس، یک نمونه از کلاس MapiMessage ایجاد کنید.
- پس از آن، موضوع، بدنه و سایر خصوصیات پیام را تنظیم کنید.
- در نهایت با استفاده از روش IGraphClient.CreateMessage(GraphKnownFolders, MapiMessage) پیام را در پوشه مورد نظر ایجاد کنید.
نمونه کد زیر نحوه ایجاد پیام با استفاده از Microsoft Graph API در سی شارپ را نشان می دهد.
// کد دسترسی را ایجاد کنید
AccessTokenProvider tokenProvider = new AccessTokenProvider();
// یک مشتری Graph ایجاد کنید
IGraphClient client = GraphClient.GetClient(tokenProvider, "tenant ID");
// یک پیام جدید ایجاد کنید
MapiMessage mm = new MapiMessage();
mm.Subject = "EMAILNET-39318 " + Guid.NewGuid().ToString();
mm.Body = "EMAILNET-39318 REST API v1.0 - Create Message";
mm.SetProperty(KnownPropertyList.DisplayTo, "to@host.com");
mm.SetProperty(KnownPropertyList.SenderName, "from");
mm.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "from@host.com");
// ایجاد پیام در پوشه صندوق ورودی
MapiMessage createdMessage = client.CreateMessage(Clients.Graph.KnownFolders.Inbox, mm);
ارسال پیام با Microsoft Graph API در سی شارپ
حال بیایید نگاهی به نحوه ارسال پیام با استفاده از Microsoft Graph API در سی شارپ بیندازیم.
- ابتدا با استفاده از روش GraphClient.GetClient(ITokenProvider, string) یک نمونه از کلاینت Microsoft Graph دریافت کنید.
- سپس، یک نمونه از کلاس MapiMessage ایجاد کنید.
- پس از آن، موضوع، بدنه و سایر خصوصیات پیام را تنظیم کنید.
- در نهایت، پیام را با استفاده از روش IGraphClient.Send(MapiMessage) ارسال کنید.
نمونه کد زیر نحوه ارسال پیام با استفاده از Microsoft Graph API در سی شارپ را نشان می دهد.
// کد دسترسی را ایجاد کنید
AccessTokenProvider tokenProvider = new AccessTokenProvider();
// یک مشتری Graph ایجاد کنید
IGraphClient client = GraphClient.GetClient(tokenProvider, "tenant ID");
// یک پیام جدید ایجاد کنید
MapiMessage mm = new MapiMessage();
mm.Subject = "EMAILNET-39318 " + Guid.NewGuid().ToString();
mm.Body = "EMAILNET-39318 REST API v1.0 - Create Message";
mm.SetProperty(KnownPropertyList.DisplayTo, "to@host.com");
mm.SetProperty(KnownPropertyList.SenderName, "from");
mm.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "from@host.com");
// پیام فرستادن
client.Send(mm);
Microsoft Graph API برای ایجاد و ارسال پیام در سی شارپ - یک مجوز رایگان دریافت کنید
میتوانید برای ایجاد و ارسال پیامها از طریق Microsoft Graph API بدون محدودیت ارزیابی، مجوز موقت رایگان دریافت کنید.
نتیجه
در این مقاله نحوه استفاده از Microsoft Graph API برای ایجاد و ارسال پیام در سی شارپ را یاد گرفتید. شما به سادگی می توانید Aspose.Email را نصب کنید و نمونه کدهای ارائه شده را در برنامه های NET خود ادغام کنید. علاوه بر این، می توانید با استفاده از مستندات به ویژگی های دیگر ارائه شده توسط Aspose.Email برای دات نت نگاهی بیندازید. همچنین، در صورت داشتن هرگونه سوال، می توانید در [تالار گفتمان14 ما ارسال کنید.