کتابخانه منبع باز روبی برای ایجاد و پردازش ایمیل

شروع کار با Mail

ساده‌ترین روش برای نصب کتابخانه Ruby-Gmail از طریق RubyGems است. لطفاً برای نصب آسان از فرمان زیر استفاده کنید.

gem install gmail

احراز هویت ایمیل در برنامه‌های Ruby

کتابخانه منبع باز Ruby-Gmail از روش‌های متعدد احراز هویت از جمله OAuth2 و نام کاربری/رمز عبور ساده پشتیبانی می‌کند. این کتابخانه امکان ورود ساده با استفاده از آدرس Gmail و رمز عبور یا رمز عبور مخصوص برنامه (توصیه‌شده برای حساب‌های دارای 2FA) را فراهم می‌آورد. به‌علاوه، اگر نیاز به استفاده از OAuth یا مدیریت ورود خارج از اسکریپت دارید، Ruby-Gmail از اتصال مبتنی بر بلوک پشتیبانی می‌کند. لطفاً توجه داشته باشید که برای امنیت، از کدگذاری مستقیم رمزها خودداری کنید؛ از متغیرهای محیطی یا مدیریت رازها استفاده کنید. مثال‌های کد زیر هر دو روش را برای پردازش احراز هویت ایمیل از طریق API روبی نشان می‌دهند.

require 'gmail'

# Basic authentication (less secure)
gmail = Gmail.connect(username, password)

# OAuth2 authentication (recommended)
gmail = Gmail.connect(:oauth2, username, access_token)

جستجو و فیلتر ایمیل‌ها از طریق API Ruby

کتابخانه Ruby-Gmail عملکرد کامل برای خواندن و جستجوی آسان پیام‌های ایمیل درون برنامه‌های Ruby فراهم کرده است. توسعه‌دهندگان می‌توانند به صندوق ورودی، پیام‌های خوانده‌نشده دسترسی داشته باشند یا به راحتی بر اساس موضوع، فرستنده یا تاریخ جستجو کنند. این کتابخانه یک رابط جستجوی قدرتمند ارائه می‌دهد که عملگرهای جستجوی Gmail را بازتاب می‌دهد. مثال زیر نشان می‌دهد که چگونه توسعه‌دهندگان نرم‌افزار می‌توانند روش‌های مختلفی را برای جستجوی پیام‌های ایمیل در برنامه‌های Ruby به کار ببرند.

# Search for unread emails from a specific sender
emails = gmail.inbox.emails(:unread, from: 'notifications@example.com')

# Search by subject
emails = gmail.inbox.emails(subject: 'Your monthly report')

# Complex searches
emails = gmail.inbox.emails(after: Date.parse('2023-01-01'), 
                           before: Date.parse('2023-01-31'),
                           has: 'attachment')

ساخت و ارسال ایمیل با Ruby

کتابخانه منبع باز Ruby-Gmail پشتیبانی کامل برای ایجاد و ارسال پیام‌های ایمیل تنها با چند خط کد Ruby فراهم کرده است. این کتابخانه ترکیب و ارسال ایمیل‌ها را ساده می‌کند و امکان افزودن محتوای HTML، فایل‌ها و پیوست‌های تصویری، ارسال ایمیل‌های انبوه، اعمال استایل‌ها و قالب‌بندی و غیره را می‌دهد. مثال زیر نشان می‌دهد که توسعه‌دهندگان نرم‌افزار چگونه می‌توانند محتوای HTML و پیوست‌ها را به پیام‌های ایمیل در برنامه‌های Ruby اضافه کنند.

gmail.deliver do
  to "recipient@example.com"
  subject "Hello from Ruby-Gmail"
  text_part do
    body "This is a test email sent using Ruby-Gmail."
  end
end

# add HTML content and attachments
gmail.deliver do
  to "recipient@example.com"
  subject "Invoice Attached"
  text_part do
    body "Please see the attached invoice."
  end
  add_file "/path/to/invoice.pdf"
end

آرشیو، حذف و جابجایی ایمیل‌ها از طریق API Ruby

کتابخانه Ruby-Gmail بسیار پر ویژگی است و می‌تواند عملیات چرخه حیات ایمیل را به‌صورت روان در برنامه‌های Ruby مدیریت کند. توسعه‌دهندگان نرم‌افزار می‌توانند به‌راحتی ایمیل‌ها را با جابجایی، برچسب‌گذاری، علامت‌گذاری به‌عنوان خوانده‌شده/خوانده‌نشده و غیره مدیریت کنند؛ همچنین می‌توانند ایمیل‌ها را به‌عنوان ستاره‌دار، خوانده‌نشده علامت‌گذاری کرده یا حتی به پوشه‌های مختلف منتقل کنند. مثال کد Ruby زیر نشان می‌دهد که چگونه ایمیل را علامت‌گذاری، برچسب‌ها را اضافه و به پوشه‌ای در داخل برنامه‌های Ruby منتقل کنید.

email = gmail.inbox.emails.first

# Mark as read/unread
email.read!
email.unread!

# Add/remove labels
email.label('Important')
email.remove_label('Important')

# Move to folder
email.move_to('Archive')