1. produkty
  2.   E-mailem
  3.   Ruby
  4.   Ruby-Gmail
 
  

Open Source Ruby knihovna pro tvorbu a zpracování e‑mailů

Bezplatné Ruby API, které umožňuje Ruby aplikacím přistupovat k účtům Gmail a manipulovat s nimi přes IMAP. Vytvářejte, odesílejte, archivujte, přesouvejte a mažte e‑mailové zprávy pomocí Ruby knihovny.

Co je knihovna Ruby-Gmail?

V době, kdy e‑mail stále hraje klíčovou roli v komunikačních pracovních postupech, vývojáři softwaru často potřebují programově komunikovat s Gmailem. Ať už jde o získávání zpráv, odesílání automatizovaných oznámení nebo sledování doručených pošt, mít správné nástroje může ušetřit hodiny práce. Ruby‑Gmail je open‑source Ruby gem, který poskytuje jednoduché, Ruby‑stylové rozhraní k Gmailu přes protokol IMAP. Vytvořil jej vývojář dcparker, knihovna abstrahuje složitost práce s čistými IMAP příkazy a místo toho nabízí čitelné, výmluvné metody pro práci s Gmailovými doručenými poštami, e‑maily, štítky, přílohami a dalšími. Pouze s několika řádky Ruby kódu mohou vývojáři softwaru vytvářet a odesílat multipart e‑mailové zprávy v prostém textu a/nebo HTML, s vloženými obrázky a přílohami.

Ruby-Gmail je skrytý poklad pro Rubyisty, kteří chtějí minimalistické, elegantní rozhraní pro automatizaci úkolů v Gmailu. Knihovna zahrnuje různé funkce pro práci s e-maily v Gmailu, jako je autentizace do Gmailu, čtení, vyhledávání nebo filtrování e‑mailů, tvorba a odesílání zpráv, odstraňování nebo mazání e‑mailů, archivace zpráv, přístup k přílohám e‑mailů, organizace e‑mailů pomocí štítků a tak dále. Aktivní vývoj knihovny a její open source povaha znamenají, že se nadále zlepšuje a přizpůsobuje změnám v Gmail API. Kromě některých skvělých funkcí existují také omezení, jako například nepodporovaná OAuth2 a závislost na IMAP, což nemusí odhalovat všechny specifické funkce Gmailu. Je to ideální volba pro skriptování úkolů nebo integraci Gmailu do lehkých Ruby aplikací.

Previous Next

Začínáme s Mail

Nejjednodušší způsob instalace knihovny Ruby-Gmail je přes RubyGems. Použijte prosím následující příkaz pro snadnou instalaci.

Nainstalujte Ruby-Gmail přes Rubygems

gem install gmail

Autentizace e‑mailu v Ruby aplikacích

Open source knihovna Ruby-Gmail podporuje více autentizačních metod, včetně OAuth2 a jednoduchého uživatelského jména/hesla. Umožňuje jednoduché přihlášení pomocí Gmailové adresy a hesla nebo hesla specifického pro aplikaci (doporučeno pro účty s 2FA). Případně, pokud potřebujete použít OAuth nebo provádět přihlášení mimo skript, Ruby-Gmail podporuje blokové připojení. Vezměte prosím na vědomí, že z bezpečnostních důvodů byste se měli vyhnout pevně zakódovaným heslům; používejte proměnné prostředí nebo správu tajemství. Následující ukázky kódu demonstrují oba způsoby zpracování autentizace e‑mailů pomocí Ruby API.

Jak provést základní a OAuth2 autentizaci e‑mailu v Ruby aplikacích?

require 'gmail'

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

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

Vyhledávání a filtrování e‑mailů pomocí Ruby API

Knihovna Ruby-Gmail poskytuje kompletní funkčnost pro snadné čtení a vyhledávání e‑mailových zpráv v Ruby aplikacích. Vývojáři mohou snadno přistupovat k doručené poště, nepřečteným zprávám nebo vyhledávat podle předmětu, odesílatele či data. Knihovna nabízí robustní rozhraní pro vyhledávání, které odráží stejné operátory jako Gmail. Následující příklad ukazuje, jak mohou vývojáři softwaru použít různé metody pro vyhledávání e‑mailových zpráv v Ruby aplikacích.

Jak vyhledávat e‑mailové zprávy v Gmailu pomocí Ruby API?

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

Skládání a odesílání e‑mailů pomocí Ruby

Otevřená knihovna Ruby-Gmail poskytuje kompletní podporu pro vytváření a odesílání e‑mailových zpráv pouhými několika řádky Ruby kódu. Knihovna usnadňuje sestavování a odesílání e‑mailů, umožňuje přidávat HTML obsah, soubory a obrázkové přílohy, odesílat hromadné e‑maily, aplikovat styly a formátování a podobně. Následující příklad ukazuje, jak mohou vývojáři softwaru přidat HTML obsah a přílohy k e‑mailovým zprávám v Ruby aplikacích.

Jak přidat HTML obsah a přílohy do e‑mailové zprávy pomocí Ruby aplikací?

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

Archivace, mazání a přesun e‑mailů pomocí Ruby API

Knihovna Ruby-Gmail je velmi bohatá na funkce a dokáže plynule zvládat operace životního cyklu e‑mailů v Ruby aplikacích. Vývojáři softwaru mohou snadno spravovat e‑maily přesouváním, označováním štítky, označováním jako přečtené/nepřečtené atd. Mohou také snadno označit e‑maily hvězdičkou, jako nepřečtené nebo je dokonce přesunout do různých složek. Následující ukázka Ruby kódu demonstruje, jak označit e‑mail, přidat štítky a přesunout jej do složky v Ruby aplikacích.

Jak označit e‑mail, přidat štítky a přesunout jej do konkrétní složky pomocí Ruby knihovny?

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')
 Čeština