1. Produktai
  2.   El. paštas
  3.   Ruby
  4.   Ruby-Gmail
 
  

Atviro kodo Ruby el. laiškų kūrimo ir apdorojimo biblioteka

Nemokama Ruby API, leidžianti Ruby programoms pasiekti ir valdyti Gmail paskyras per IMAP. Kurti, siųsti, archyvuoti, perkelti ir ištrinti el. laiškus naudojant Ruby biblioteką.

Kas yra Ruby-Gmail biblioteka?

Amžiuje, kai el. paštas vis dar atlieka svarbų vaidmenį komunikacijos darbo procesuose, programinės įrangos kūrėjai dažnai turi programiškai bendrauti su Gmail. Nesvarbu, ar tai ataskaitų ištrauka, automatizuotų pranešimų siuntimas, ar pašto dėžučių stebėjimas, turint tinkamus įrankius galima sutaupyti valandas darbo. Ruby-Gmail yra atviro kodo Ruby gem, suteikiantis paprastą, Ruby stiliaus sąsają su Gmail per IMAP protokolą. Sukurtas kūrėjo dcparker, biblioteka abstrahuoja sudėtingumą, susijusį su tiesioginiais IMAP komandomis, ir vietoje to suteikia skaitomus, išraiškingus metodus darbui su Gmail dėžutėmis, el. laiškais, etiketėmis, priedais ir kt. Tik kelios Ruby kodo eilutės leidžia programinės įrangos kūrėjams kurti ir siųsti daugių dalių el. laiškus paprastu tekstu ir/arba HTML, su įterptais paveikslėliais ir priedais.

Ruby‑Gmail yra paslėptas brangakmenis Ruby programuotojams, norintiems minimalios, elegantiškos sąsajos Gmail užduočių automatizavimui. Biblioteka apima įvairias funkcijas darbui su Gmail el. laiškais, tokias kaip autentifikavimas Gmail, skaitymas, paieška arba filtravimas el. laiškų, laiškų kūrimas ir siuntimas, laiškų šalinimas arba ištrynimas, laiškų archyvavimas, prieiga prie priedų, el. laiškų organizavimas naudojant etiketes ir t.t. Bibliotekos aktyvus vystymas ir atviro kodo pobūdis reiškia, kad ji nuolat tobulėja ir prisitaiko prie Gmail API pokyčių. Be puikių funkcijų yra ir kai kurių apribojimų, pavyzdžiui, OAuth2 dar nepalaikomas ir biblioteka remiasi IMAP, kuris gali neatskleisti visų Gmail specifinių funkcijų. Tai puikiai tinka skriptų užduotims arba Gmail integravimui į lengvas Ruby programas.

Previous Next

Pradžia su Mail

Paprasčiausias būdas įdiegti Ruby‑Gmail biblioteką – per RubyGems. Norėdami lengvai įdiegti, naudokite šią komandą.

Įdiekite Ruby-Gmail per Rubygems

gem install gmail

El. pašto autentifikavimas Ruby programose

Atviro kodo Ruby-Gmail biblioteka palaiko kelis autentifikacijos metodus, įskaitant OAuth2 ir paprastą vartotojo vardą/slaptažodį. Ji leidžia paprastą prisijungimą naudojant Gmail adresą ir slaptažodį arba programai specifinį slaptažodį (rekomenduojama paskyroms su 2FA). Alternatyviai, jei reikia naudoti OAuth arba tvarkyti prisijungimą už skripto ribų, Ruby-Gmail palaiko blokų pagrindu veikiančią jungtį. Atkreipkite dėmesį, kad saugumui reikėtų vengti slaptažodžių kodo įterpimo; naudokite aplinkos kintamuosius arba paslapčių valdymą. Žemiau pateikti kodo pavyzdžiai demonstruoja abu metodus, kaip tvarkyti el. pašto autentifikacijos procesą per Ruby API.

Kaip atlikti bazinį ir OAuth2 el. pašto autentifikavimą Ruby programose?

require 'gmail'

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

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

Ieškoti ir filtruoti el. laiškus per Ruby API

Ruby-Gmail biblioteka suteikė visą funkcionalumą, leidžiantį lengvai skaityti ir ieškoti el. pašto žinučių Ruby programose. Kūrėjai gali lengvai pasiekti gautų laiškų dėžutę, neskaitytas žinutes arba ieškoti pagal temą, siuntėją ar datą. Biblioteka siūlo patikimą paieškos sąsają, kuri atspindi Gmail paieškos operatorius. Žemiau pateiktas pavyzdys demonstruoja, kaip programinės įrangos kūrėjai gali taikyti įvairius metodus el. pašto žinučių paieškai Ruby programose.

Kaip ieškoti el. laiškų Gmail per 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')

El. laiškų kūrimas ir siuntimas per Ruby

Atviro kodo Ruby-Gmail biblioteka suteikia visapusišką palaikymą kuriant ir siunčiant el. laiškus tik keliais Ruby kodo eilutėmis. Biblioteka supaprastina laiškų kūrimą ir siuntimą, leidžia pridėti HTML turinį, failų ir vaizdų priedus, siųsti masinius laiškus, taikyti stilius ir formatavimą ir t.t. Toliau pateiktas pavyzdys rodo, kaip programinės įrangos kūrėjai gali pridėti HTML turinį ir priedus prie el. laiškų Ruby programose.

Kaip pridėti HTML turinį ir priedus prie el. laiško naudojant Ruby programas?

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

Archyvuoti, ištrinti ir perkelti el. laiškus per Ruby API

Ruby-Gmail biblioteka yra labai funkcionaliai turtinga ir gali sklandžiai tvarkyti el. laiškų gyvavimo ciklo operacijas Ruby programose. Programinės įrangos kūrėjai gali lengvai valdyti laiškus perkelti, žymėti, pažymėti kaip perskaitytus/neperskaitytus ir t.t. jie taip pat gali lengvai pažymėti laiškus žvaigždute, neskaitytus arba net perkelti juos į skirtingus aplankus. Toliau pateiktas Ruby kodo pavyzdys demonstruoja, kaip pažymėti laišką, pridėti etiketes ir perkelti į aplanką Ruby programose.

Kaip pažymėti el. laišką, pridėti etiketes ir perkelti į konkretų aplanką naudojant Ruby biblioteką?

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