یکپارچه‌سازی Gmail در C# با احراز هویت OAuth2 و Aspose.Email

• Aspose.Email for .NET: یکپارچه‌سازی Gmail در پروژه‌های C#
• دریافت توکن OAuth2 برای یکپارچه‌سازی API Gmail در C#
  • ایجاد یک پروژه در Google Cloud Console
  • پیکربندی صفحه رضایت OAuth
  • ایجاد اعتبارنامه‌های OAuth
  • دریافت توکن OAuth 2.0
• مدیریت پیام‌های Gmail در C# با Aspose.Email
  • نمای کلی روش‌ها برای مدیریت پیام‌های Gmail در C#
  • ارسال پیام‌های Gmail در C#
  • افزودن پیام‌های Gmail با Aspose.Email for .NET
  • دریافت و حذف پیام‌های Gmail در C#
• مدیریت فیلترهای Gmail با Aspose.Email در C#
  • ایجاد و فهرست‌کردن فیلترهای Gmail
  • حذف فیلترهای Gmail

Gmail یک سرویس ایمیل محبوب با ویژگی‌های فراوان و قابلیت ادغام با برنامه‌های مختلف است. برای توسعه‌دهندگان .NET، افزودن پشتیبانی Gmail به برنامه‌هایشان می‌تواند تجربه کاربری را بهبود بخشد، زیرا به کاربران اجازه می‌دهد ایمیل‌ها را مستقیماً در داخل برنامه مدیریت کنند.

در این مقاله، نحوه‌ی دستیابی به یکپارچه‌سازی بی‌نقص Gmail در .NET را با استفاده از یک کتابخانه پیشرفته بررسی می‌کنیم. عملیات‌های اساسی مانند ارسال، دریافت، افزودن و حذف پیام‌ها، همچنین مدیریت فیلترها برای خودکارسازی سازماندهی ایمیل‌ها را پوشش می‌دهیم. چه برای ارسال گزارش‌های خودکار، بایگانی ایمیل‌های مهم یا اعمال فیلترها برای مدیریت پیام‌های ورودی نیاز داشته باشید، API ما این وظایف را بسیار آسان‌تر می‌کند.

در پایان این مقاله، درک جامع‌تری از نحوه مدیریت برنامه‌نویسی پیام‌ها و فیلترهای Gmail خواهید داشت و قادر خواهید بود برنامه‌های کاربردی ایمیل‌پرداز پیشرفته و کارآمدتری بسازید.

Aspose.Email for .NET: یکپارچه‌سازی Gmail در پروژه‌های C#

Aspose.Email for .NET یک کتابخانه قدرتمند است که برای ساده‌سازی یکپارچه‌سازی قابلیت‌های ایمیل در برنامه‌های .NET طراحی شده و پشتیبانی جامع از Gmail را ارائه می‌دهد. APIهای آن به توسعه‌دهندگان امکان می‌دهد به راحتی انواع فرمت‌های ایمیل را مدیریت و دستکاری کنند و تجربه‌ای یکپارچه برای کار با ایمیل‌ها، تقویم‌ها، مخاطبین و موارد دیگر در داخل برنامه‌هایشان فراهم آورند. با استفاده از Aspose.Email Gmail API، توسعه‌دهندگان می‌توانند به سادگی به حساب‌های Gmail دسترسی پیدا کنند، ایمیل ارسال و دریافت کنند و عملیات پیچیده ایمیلی را به‌صورت برنامه‌نویسی انجام دهند. این نه تنها بهره‌وری را افزایش می‌دهد بلکه تجربه کاربری را با ارائه یک رابط یکپارچه برای مدیریت ایمیل مستقیماً در برنامه بهبود می‌بخشد. با مجموعه وسیعی از ویژگی‌ها و سازگاری چندپلتفرمی، Aspose.Email for .NET ابزار ارزشمندی برای توسعه‌دهندگانی است که به دنبال ساخت برنامه‌های پیشرفته با پشتیبانی کارآمد از Gmail هستند.

برای بهره‌گیری از قدرت API، می‌توانید یا DLL آن را دانلود کنید یا از NuGet با استفاده از فرمان زیر نصب کنید:

PM> Install-Package Aspose.Email

با داشتن کتابخانه در پروژه‌تان، می‌توانید کدنویسی را شروع کنید.

دریافت توکن OAuth2 برای ادغام API جیمیل در C#

برای ادغام با صندوق ایمیل Gmail با استفاده از C#، نیاز به دریافت یک توکن OAuth 2.0 دارید. مراحل زیر را برای پیکربندی احراز هویت OAuth در برنامهٔ خود دنبال کنید.

ایجاد یک پروژه در کنسول Google Cloud

1. به Google Cloud Console بروید.
2. یک پروژه جدید ایجاد کنید یا یک پروژه موجود را انتخاب کنید.
3. Gmail API را فعال کنید:
   • به API & Services → Library بروید.
   • Gmail API را جستجو کنید و آن را فعال کنید.

پیکربندی صفحه رضایت OAuth

1. به API & Services → صفحه رضایت OAuth بروید.
2. نوع کاربر را انتخاب کنید (داخلی یا خارجی).
3. اطلاعات پایه را پر کنید (نام برنامه، ایمیل تماس و غیره).
4. دامنه‌های مورد نیاز را اضافه کنید:
   • https://mail.google.com/: دسترسی کامل به Gmail.
   • https://www.googleapis.com/auth/gmail.readonly: دسترسی فقط‑خواندنی به ایمیل‌ها.
   • https://www.googleapis.com/auth/gmail.send: اجازه ارسال فقط ایمیل‌ها.
   • https://www.googleapis.com/auth/gmail.modify: خواندن و تغییر ایمیل‌ها (علامت‌گذاری به‌عنوان خوانده‌شده/خوانده‌نشده، حذف، جابجایی پیام‌ها).
   • https://www.googleapis.com/auth/gmail.compose: مدیریت پیش‌نویس‌ها (ایجاد، خواندن، به‌روزرسانی، حذف).

ایجاد اعتبارهای OAuth

1. به API & Services → Credentials بروید.
2. Create Credentials را کلیک کنید و OAuth client ID را انتخاب کنید.
3. نوع برنامه را انتخاب کنید (مثلاً “Desktop app” یا “Web application”).
4. client_id و client_secret را برای استفاده بعدی ذخیره کنید.

دریافت توکن OAuth 2.0

یک توکن تازه‌سازی به برنامه شما اجازه می‌دهد تا بدون نیاز به درخواست مجدد مجوز از کاربر، یک توکن دسترسی جدید دریافت کند و دسترسی بی‌وقفه و یکپارچه به Gmail را تضمین کند.

برای دریافت یک توکن تازه‌سازی، از روش زیر استفاده کنید:

متد GetAccessTokenByAuthCode توکن refresh token را برمی‌گرداند که می‌توان بعداً از آن برای دریافت یک توکن دسترسی جدید بدون تکرار فرآیند احراز هویت استفاده کرد.

این متد چه کاری انجام می‌دهد:

1. ساختن درخواست HTTP: یک درخواست POST به نقطه انتهایی توکن Google OAuth تنظیم می‌کند با هدرها و نوع محتوا مناسب.
2. کدگذاری پارامترها: شناسه مشتری، رمز مشتری، کد مجوز، URI بازگردانی، و نوع اعطای دسترسی به‌صورت URL‑encoded شده و در بدنه درخواست گنجانده می‌شوند.
3. ارسال درخواست: درخواست به نقطه انتهایی توکن OAuth 2.0 گوگل ارسال می‌شود.
4. پردازش پاسخ: پاسخ خوانده شده و به‌صورت یک شیء TokenResponse تجزیه می‌شود که شامل توکن‌های دسترسی و تازه‌سازی است.

با اجرای این روش، برنامه شما می‌تواند به‌صورت ایمن توکن تازه‌سازی را دریافت و استفاده کند تا دسترسی به Gmail را بدون درخواست مکرر مجوز از کاربران حفظ کند.

مدیریت پیام‌های Gmail در C# با Aspose.Email

کتابخانه Aspose.Email for .NET روش‌هایی برای مدیریت پیام‌های Gmail ارائه می‌دهد، از جمله فهرست کردن، بازیابی، ارسال، افزودن و حذف پیام‌ها. این بخش نمای کلی از این عملیات‌ها را فراهم می‌کند و نشان می‌دهد چگونه می‌توان از آن‌ها به‌طور مؤثر استفاده کرد.

نمای کلی روش‌ها برای مدیریت پیام‌های Gmail در C#

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

• List Messages: تمام پیام‌ها را در یک صندوق پستی با استفاده از ListMessages() بازیابی کنید، که یک لیست از اشیاء GmailMessageInfo برمی‌گرداند.
• Fetch Message: به محتوای کامل یک پیام خاص با FetchMessage(string id) دسترسی پیدا کنید، که یک نمونه از MailMessage برمی‌گرداند.
• Send Messages: پیام‌ها را به‌صورت مستقیم با استفاده از SendMessage(MailMessage msg) ارسال کنید.
• Append Messages: پیام‌ها را به صندوق پستی Gmail اضافه کنید، بدون عبور از طبقه‌بندی استاندارد:
  • AppendMessage(MailMessage msg) برای رفتار پیش‌فرض.
  • AppendMessage(MailMessage msg, string labelName) برای تعیین برچسب سفارشی.
• Delete Messages:
  • DeleteMessage(string id, bool moveToTrash) برای انتقال پیام‌ها به سطل زباله یا حذف دائمی.
  • DeleteMessage(string id) برای حذف فوری و دائمی.

ارسال پیام‌های Gmail در C#

قابلیت‌های ارسال ایمیل Gmail را در برنامه‌های C# خود تنها با چند مرحله یکپارچه کنید. نمونه کد زیر نشان می‌دهد چگونه با استفاده از Gmail API در C# یک ایمیل همراه با پیوست ارسال کنید. پس از نصب Aspose.Email، کلاینت Gmail را تنظیم کنید، یک پیام ایمیل با تمام جزئیات ضروری از جمله پیوست‌ها ایجاد کنید و در نهایت ایمیل را با استفاده از متد SendMessage ارسال کنید و یک شناسه پیام به عنوان تأیید دریافت کنید.

مراحل:

1. ‎GmailClient را با اعتبارهای مشتری و توکن‌های دسترسی مقداردهی اولیه کنید.
2. یک شیء ‎MailMessage را با آدرس‌های ایمیل فرستنده و گیرنده، موضوع و متن ایجاد کنید.
3. یک پیوست به پیام اضافه کنید با استفاده از Attachments.Add() و مسیر فایل مشخص‌شده.
4. پیام را با متد SendMessage ارسال کنید، که شناسه پیام را برای تأیید برمی‌گرداند.

Code sample:

افزودن پیام‌های Gmail با Aspose.Email for .NET

یک پیام را اضافه کردن (Appending) به شما امکان می‌دهد ایمیل‌ها را مستقیماً به صندوق‌پستی Gmail اضافه کنید، بدون عبور از طبقه‌بندی معمول. قطعه کد زیر نشان می‌دهد چگونه یک پیام ایمیل را به پوشه “Inbox” با استفاده از یک کلاینت Gmail اضافه کنیم. این کار شامل ایجاد یک پیام ایمیل، اضافه کردن آن به Inbox با یک برچسب خاص، و تأیید موفقیت عملیات با چاپ شناسه پیام است.

مراحل:

1. یک نمونه از کلاینت Gmail را با استفاده از متد GmailClient.GetInstance() به همراه پارامترهای لازم (clientId, clientSecret, refreshToken, email) ایجاد کنید.
2. یک شیء MailMessage را با جزئیاتی مانند ایمیل فرستنده، ایمیل گیرنده، موضوع پیام و متن بدنه ایجاد کنید.
3. پیام را به پوشه Inbox اضافه کنید.

نمونه کد:

دریافت و حذف پیام‌های Gmail در C#

دریافت پیام‌ها به شما امکان دسترسی به محتوای آن‌ها را می‌دهد، در حالی که حذف کمک می‌کند تا پاکیزگی صندوق پستی شما حفظ شود. نمونه کد زیر استفاده از رابط IGmailClient را برای تعامل با صندوق پستی Gmail نشان می‌دهد. این نمونه تمام پیام‌های ایمیل را فهرست می‌کند، جزئیات (موضوع و بدنه) سه پیام اول را دریافت و نمایش می‌دهد و سپس هر یک از این پیام‌ها را با انتقال به سطل زباله حذف می‌کند.

مراحل:

1. کلاینت Gmail را با استفاده از اعتبارهای ارائه‌شده (clientId، clientSecret، refreshToken و email) با فراخوانی GmailClient.GetInstance() مقداردهی اولیه کنید.
2. با استفاده از متد ListMessages() فهرستی از تمام پیام‌های موجود در صندوق ایمیل Gmail دریافت کنید.
3. در اولین سه پیام صندوق ایمیل (در صورت موجود بودن) تکرار کنید. برای هر پیام:
   • جزئیات پیام، مانند موضوع و بدنه، را با استفاده از FetchMessage(messages[i].Id) دریافت کنید.
   • موضوع و بدنه را در کنسول چاپ کنید.
4. هر پیام پردازش‌شده را با فراخوانی DeleteMessage(messages[i].Id, true) حذف کنید، که پیام‌ها را به سطل زباله منتقل می‌کند و امکان بازیابی را فراهم می‌سازد.

نمونه کد:

مدیریت فیلترهای Gmail با Aspose.Email در C#

ایجاد و فهرست‌کردن فیلترهای Gmail

فیلترها به مدیریت ایمیل‌های ورودی بر اساس معیارهایی مانند موضوع یا فرستنده کمک می‌کنند. Aspose.Email متد CreateFilter از GmailClient معیارها و اقدامات را تعریف می‌کند (مثلاً برچسب‌گذاری ایمیل‌های مهم). متد ListFilters تمام فیلترهای اعمال‌شده بر صندوق پستی را نمایش می‌دهد. نمونه کد زیر نشان می‌دهد چگونه می‌توان با استفاده از رابط IGmailClient با یک صندوق پستی Gmail تعامل داشت. این نمونه یک فیلتر برای ایمیل‌های دارای موضوع خاص ایجاد می‌کند، برچسبی به آن‌ها اعمال می‌کند و تمام فیلترهای موجود در صندوق پستی را فهرست می‌کند.

مراحل:

1. یک نمونه از GmailClient را با استفاده از اعتبارهای داده شده (clientId، clientSecret، refreshToken و email) با فراخوانی GmailClient.GetInstance() ایجاد کنید.
2. فیلتر پیام را با ایجاد یک شیء Filter تعریف کنید، MatchingCriteria را تنظیم کنید تا پیام‌هایی با موضوع شامل «Important» فیلتر شوند، و Action را برای افزودن برچسب «IMPORTANT» به پیام‌های مطابق تعریف کنید.
3. از متد CreateFilter(filter) برای افزودن فیلتر تعریف‌شده به حساب Gmail استفاده کنید.
4. تمام فیلترهای موجود در حساب Gmail را با استفاده از متد ListFilters() بازیابی کنید و با پیمایش هر فیلتر، شناسه آن را در کنسول نمایش دهید.

نمونه کد:

حذف فیلترهای Gmail

وقتی فیلترها دیگر مورد نیاز نیستند، آنها را حذف کنید. کد نمونه زیر فرآیند اتصال به حساب Gmail با استفاده از رابط IGmailClient، فهرست‌کردن تمام فیلترهای موجود و سپس حذف هر یک از این فیلترها را نشان می‌دهد.

مراحل:

1. با ایجاد یک نمونه از GmailClient و استفاده از اعتبارهای لازم (clientId، clientSecret، refreshToken و email)، مشتری Gmail را مقداردهی اولیه کنید و GmailClient.GetInstance() را فراخوانی کنید.
2. فیلترهای موجود را با فراخوانی متد ListFilters() بازیابی کنید. این متد فهرستی از تمام فیلترهای فعلی پیکربندی‌شده در صندوق‌پستی Gmail را برمی‌گرداند.
3. در لیست به‌دست‌آمده بر روی هر فیلتر حلقه بزنید.
4. برای هر فیلتر، با اجرای DeleteFilter(filter.Id) آن را از حساب Gmail حذف کنید.
5. برای هر فیلتر حذف‌شده، پیام تأیید را در کنسول چاپ کنید که شناسه فیلتر خاص حذف‌شده را نشان می‌دهد.

نمونه کد:

نتیجه‌گیری

در این مقاله، ما یکپارچه‌سازی عملکرد Gmail را در برنامه‌های .NET با استفاده از Aspose.Email Gmail API معرفی کرده‌ایم. با دنبال کردن مراحل بیان‌شده، می‌توانید به‌طور مؤثر احراز هویت OAuth2 را در C# پیاده‌سازی کنید و دسترسی ایمن به حساب‌های Gmail را فراهم نمایید. ویژگی‌های جامع ارائه‌شده توسط Aspose.Email for .NET به توسعه‌دهندگان امکان مدیریت پیام‌های Gmail، خودکارسازی وظایف ایمیل و ارتقاء عملکرد برنامه را می‌دهد. چه نیاز به ارسال، دریافت، افزودن یا حذف پیام‌های Gmail داشته باشید، ترکیب Gmail API در C# و یکپارچه‌سازی .NET Gmail راه‌حلی قدرتمند برای مدیریت ایمیل در پروژه‌های C# شما فراهم می‌کند.

به منابع عمومی رایگان ما توجه کنید:

• مرجع API اطلاعات عمیق درباره کلاس‌ها و متدها را ارائه می‌دهد.
• مستندات راهنمایی‌های جامع همراه با مثال‌ها را فراهم می‌کند.
• انجمن پشتیبانی به کاربران امکان می‌دهد برای دریافت کمک و بحث درباره مشکلات اقدام کنند.
• وبلاگ به‌روزرسانی‌ها، آموزش‌ها و بهترین شیوه‌ها را ارائه می‌دهد.

همین امروز با Aspose.Email for .NET شروع کنید!

موارد مرتبط

• دسترسی به Gmail از طریق IMAP با احراز هویت OAuth2 در C#
• تولیدکننده Gmail - ایجاد Gmail موقت و یکبار مصرف
• ایجاد، به‌روزرسانی یا حذف Google Calendar در C#