Thư viện Tạo & Xử lý Email Ruby mã nguồn mở

Bắt đầu với Mail

Cách dễ nhất để cài đặt thư viện Ruby-Gmail là thông qua RubyGems. Vui lòng sử dụng lệnh sau để cài đặt nhanh chóng.

gem install gmail

Xác thực email trong các ứng dụng Ruby

Thư viện Ruby-Gmail mã nguồn mở hỗ trợ nhiều phương thức xác thực bao gồm OAuth2 và tên người dùng/mật khẩu thông thường. Nó cho phép đăng nhập đơn giản bằng địa chỉ Gmail và mật khẩu hoặc mật khẩu dành riêng cho ứng dụng (được khuyến nghị cho các tài khoản có 2FA). Ngoài ra, nếu bạn cần sử dụng OAuth hoặc xử lý đăng nhập bên ngoài script, Ruby-Gmail hỗ trợ kết nối dựa trên khối. Lưu ý rằng vì bảo mật, tránh mã hoá cứng mật khẩu; hãy sử dụng biến môi trường hoặc quản lý bí mật. Các ví dụ mã sau đây minh họa cả hai phương pháp xử lý xác thực email thông qua API Ruby.

require 'gmail'

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

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

Tìm kiếm và lọc email qua API Ruby

Thư viện Ruby-Gmail đã cung cấp đầy đủ chức năng để dễ dàng đọc và tìm kiếm các tin nhắn email trong các ứng dụng Ruby. Các nhà phát triển có thể truy cập hộp thư đến, các tin nhắn chưa đọc, hoặc tìm kiếm theo tiêu đề, người gửi, hoặc ngày một cách dễ dàng. Thư viện cung cấp giao diện tìm kiếm mạnh mẽ phản ánh các toán tử tìm kiếm của Gmail. Ví dụ sau đây minh họa cách các nhà phát triển phần mềm có thể áp dụng các phương pháp khác nhau để tìm kiếm tin nhắn email trong các ứng dụng 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')

Soạn và gửi email qua Ruby

Thư viện Ruby-Gmail mã nguồn mở đã cung cấp hỗ trợ đầy đủ cho việc tạo và gửi tin nhắn email chỉ với vài dòng mã Ruby. Thư viện giúp việc soạn và gửi email trở nên đơn giản, cho phép thêm nội dung HTML, tệp và hình ảnh đính kèm, gửi email hàng loạt, áp dụng kiểu dáng và định dạng, v.v. Ví dụ sau đây cho thấy các nhà phát triển phần mềm có thể thêm nội dung HTML và tệp đính kèm vào tin nhắn email trong các ứng dụng 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

Lưu trữ, xóa và di chuyển email qua API Ruby

Thư viện Ruby-Gmail rất giàu tính năng và có thể xử lý các hoạt động vòng đời email một cách mượt mà trong các ứng dụng Ruby. Các nhà phát triển phần mềm có thể dễ dàng quản lý email bằng cách di chuyển, gắn nhãn, đánh dấu đã đọc/chưa đọc, v.v. họ cũng có thể đánh dấu email là đã gắn sao, chưa đọc, hoặc thậm chí di chuyển chúng tới các thư mục khác. Ví dụ mã Ruby sau đây minh họa cách Đánh dấu Email, thêm nhãn và di chuyển tới thư mục trong các ứng dụng 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')