1. Produkti
  2.   E-pasts
  3.   Ruby
  4.   Ruby-Gmail
 
  

Atvērtā koda Ruby e-pasta izveides un apstrādes bibliotēka

Bezmaksas Ruby API, kas ļauj Ruby lietojumprogrammām piekļūt un pārvaldīt Gmail kontus caur IMAP. Rakstīt, nosūtīt, arhivēt, pārvietot un dzēst e-pasta ziņojumus, izmantojot Ruby bibliotēku.

Kas ir Ruby-Gmail bibliotēka?

Laikmetā, kur e-pasts joprojām spēlē izšķirošu lomu komunikācijas darba plūsmās, programmatūras izstrādātāji bieži ir spiesti programmatūrā mijiedarboties ar Gmail. Neatkarīgi no tā, vai tas ir atskaišu izgūšana, automatizētu paziņojumu sūtīšana vai iesūtnes uzraudzība, pareizo rīku izmantošana var ietaupīt stundas darba. Ruby-Gmail ir atvērtā koda Ruby gems, kas nodrošina vienkāršu, Ruby‑stilīgu interfeisu Gmail, izmantojot IMAP protokolu. To izveidojis izstrādātājs dcparker, un bibliotēka abstraktē prom IMAP komandu sarežģītību, piedāvājot lasāmus, izteiksmīgus metodus darbam ar Gmail iesūtēm, e-pastiem, birkām, pielikumiem un daudz ko citu. Ar tikai pāris Ruby koda rindām programmatūras izstrādātāji var izveidot un nosūtīt daudzdaļīgus e-pasta ziņojumus teksta un/vai HTML formātā, ar iekļautām bildēm un pielikumiem.

Ruby-Gmail ir slēpts dārgakmens Ruby izstrādātājiem, kuri vēlas minimālu, elegantu saskarni Gmail uzdevumu automatizēšanai. Bibliotēka ietver dažādas funkcijas darbam ar Gmail e-pastiem, piemēram, autentifikāciju Gmail, e-pastu lasīšanu, meklēšanu vai filtrēšanu, ziņu sastādīšanu un nosūtīšanu, e-pasta noņemšanu vai dzēšanu, ziņu arhivēšanu, piekļuvi e-pasta pielikumiem, e-pastu organizēšanu, izmantojot birkas, utt. Bibliotēkas aktīvā izstrāde un atvērtā koda daba nozīmē, ka tā turpina uzlaboties un pielāgoties Gmail API izmaiņām. Papildus dažām lieliskām funkcijām ir arī dažas ierobežojumi, piemēram, OAuth2 vēl netiek atbalstīts un tas balstās uz IMAP, kas var neatklāt visas Gmail‑specifiskās iespējas. Tā ir ideāla izvēle skriptu uzdevumiem vai Gmail integrēšanai vieglās Ruby lietotnēs.

Previous Next

Sākšana ar Mail

Visvienkāršākais veids, kā instalēt Ruby-Gmail bibliotēku, ir caur RubyGems. Lūdzu, izmantojiet šādu komandu vienkāršai instalēšanai.

Instalējiet Ruby-Gmail caur Rubygems

gem install gmail

E-pasta autentifikācija Ruby lietojumprogrammās

Atvērtā koda Ruby-Gmail bibliotēka atbalsta vairākas autentifikācijas metodes, tostarp OAuth2 un vienkāršu lietotājvārda/paroles kombināciju. Tā ļauj vienkāršu pieteikšanos, izmantojot Gmail adresi un paroli vai lietotnei specifisku paroli (ieteicams kontiem ar 2FA). Alternatīvi, ja jums jāizmanto OAuth vai jāveic pieteikšanās ārpus skripta, Ruby-Gmail atbalsta bloka balstītu savienojumu. Lūdzu, ņemiet vērā, ka drošības nolūkā jāizvairās no paroļu cieto kodēšanas; izmantojiet vides mainīgos vai slepeno informācijas pārvaldību. Zemāk esošie koda piemēri demonstrē abas metodes, kā apstrādāt e-pasta autentifikācijas, izmantojot Ruby API.

Kā veikt pamata un OAuth2 e-pasta autentifikāciju Ruby lietojumprogrammās?

require 'gmail'

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

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

Meklēt un filtrēt e-pastus, izmantojot Ruby API

Ruby-Gmail bibliotēka nodrošina pilnīgu funkcionalitāti, lai viegli lasītu un meklētu e-pasta ziņojumus Ruby lietojumprogrammās. Izstrādātāji var viegli piekļūt iesūtni, neizlasītām ziņām vai meklēt pēc temata, sūtītāja vai datuma. Bibliotēka piedāvā stabilu meklēšanas interfeisu, kas atspoguļo Gmail paša meklēšanas operatorus. Zemāk esošais piemērs demonstrē, kā programmatūras izstrādātāji var izmantot dažādas metodes e-pasta ziņojumu meklēšanai Ruby lietojumprogrammās.

Kā meklēt e-pasta ziņojumus Gmail, izmantojot 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')

E-pasta sastādīšana un nosūtīšana ar Ruby

Atvērtā koda Ruby-Gmail bibliotēka nodrošina pilnīgu atbalstu e-pasta ziņojumu izveidei un sūtīšanai, izmantojot tikai pāris Ruby koda rindas. Bibliotēka ļauj vienkārši sastādīt un sūtīt e-pastus, pievienot HTML saturu, failus un attēlu pielikumus, sūtīt lielapjoma e-pastus, piemērot stilus un formatēšanu utt. Zemāk esošais piemērs parāda, kā programmatūras izstrādātāji var pievienot HTML saturu un pielikumus e-pasta ziņojumiem Ruby lietotnēs.

Kā pievienot HTML saturu un pielikumu e-pasta ziņojumam, izmantojot Ruby lietojumprogrammas?

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

Arhivēt, dzēst un pārvietot e-pastus, izmantojot Ruby API

Ruby-Gmail bibliotēka ir ļoti bagāta ar funkcijām un spēj gludi pārvaldīt e-pasta dzīves cikla darbības ruby lietotnēs. Programmatūras izstrādātāji var vienkārši pārvaldīt e-pastus, pārvietojot, piešķirot birkas, atzīmējot kā izlasītus/neizlasītus utt. Viņi arī var viegli atzīmēt e-pastus kā izceltus, neizlasītus vai pat pārvietot tos uz dažādām mapēm. Zemāk esošais Ruby koda piemērs demonstrē, kā atzīmēt e-pastu, pievienot birkas un pārvietot uz mapi ruby lietotnēs.

Kā atzīmēt e-pastu, pievienot birkas un pārvietot uz konkrētu mapi, izmantojot Ruby bibliotēku?

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