مكتبة إنشاء ومعالجة البريد الإلكتروني بروبي مفتوحة المصدر

البدء مع Mail

أسهل طريقة لتثبيت مكتبة Ruby-Gmail هي عبر RubyGems. يرجى استخدام الأمر التالي للتثبيت السهل.

gem install gmail

مصادقة البريد الإلكتروني داخل تطبيقات Ruby

تدعم مكتبة Ruby-Gmail مفتوحة المصدر طرق مصادقة متعددة بما في ذلك OAuth2 واسم المستخدم/كلمة المرور العاديين. تسمح بتسجيل دخول بسيط باستخدام عنوان Gmail وكلمة المرور أو كلمة مرور مخصصة للتطبيق (مُوصى بها للحسابات التي تستخدم المصادقة الثنائية). بدلاً من ذلك، إذا كنت بحاجة إلى استخدام OAuth أو التعامل مع تسجيل الدخول خارج السكربت، تدعم Ruby-Gmail الاتصال القائم على الكتل. يرجى ملاحظة أنه لأسباب أمنية، يجب تجنب كتابة كلمات المرور مباشرة في الشيفرة؛ استخدم المتغيرات البيئية أو إدارة الأسرار. الأمثلة البرمجية التالية توضح كلا الطريقتين لمعالجة مصادقة البريد الإلكتروني عبر واجهة برمجة تطبيقات Ruby.

require 'gmail'

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

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

البحث وتصفية الرسائل عبر واجهة برمجة تطبيقات 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

أرشفة وحذف ونقل الرسائل عبر واجهة برمجة تطبيقات 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')