Библиотека с отворен код за създаване и обработка на имейли в Ruby

Започване с Mail

Най-лесният начин за инсталиране на библиотеката Ruby-Gmail е чрез RubyGems. Моля, използвайте следната команда за бърза инсталация.

gem install gmail

Имейл автентикация в Ruby приложения

Отвореният код Ruby-Gmail библиотека поддържа множество методи за удостоверяване, включително OAuth2 и обикновено потребителско име/парола. Тя позволява прост вход с Gmail адрес и парола или парола за конкретно приложение (препоръчително за акаунти с 2FA). Алтернативно, ако трябва да използвате OAuth или да обработвате вход извън скрипта, Ruby-Gmail поддържа връзка, базирана на блокове. Моля, имайте предвид, че за сигурност трябва да избягвате вграждането на пароли в кода; използвайте променливи на околната среда или управление на тайни. Следните примерни кодове демонстрират и двата метода за обработка на удостоверяването на имейли чрез Ruby API.

require 'gmail'

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

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

Търсене и филтриране на имейли чрез Ruby API

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 API

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')