1. Produkter
  2.   E-post
  3.   Ruby
  4.   Ruby-Gmail
 
  

Öppen källkod Ruby e-postskapande- och bearbetningsbibliotek

Gratis Ruby-API som låter Ruby-appar komma åt och manipulera Gmail-konton via IMAP. Skapa, skicka, arkivera, flytta och radera e-postmeddelanden via Ruby-biblioteket.

Vad är Ruby-Gmail-biblioteket?

I en tid där e‑post fortfarande spelar en avgörande roll i kommunikationsflöden, behöver mjukvaruutvecklare ofta interagera med Gmail programatiskt. Oavsett om det handlar om att hämta rapporter, skicka automatiska aviseringar eller övervaka inkorgar, kan rätt verktyg spara timmar av arbete. Ruby-Gmail är ett open‑source Ruby‑gem som erbjuder ett enkelt, Ruby‑likt gränssnitt till Gmail via IMAP‑protokollet. Skapat av utvecklaren dcparker, abstraherar biblioteket bort komplexiteten i att hantera råa IMAP‑kommandon och ger istället läsbara, uttrycksfulla metoder för att arbeta med Gmail‑inkorgar, e‑post, etiketter, bilagor och mer. Med bara ett par rader Ruby‑kod kan mjukvaruutvecklare skapa och skicka multipart‑e‑postmeddelanden i klartext och/eller HTML, med inbäddade bilder och bilagor.

Ruby-Gmail är en dold pärla för Rubyister som vill ha ett minimalt, elegant gränssnitt för att automatisera Gmail-uppgifter. Biblioteket innehåller olika funktioner för att arbeta med Gmail-e-post, såsom autentisering till Gmail, läsa, söka eller filtrera e-post, komponera och skicka meddelanden, ta bort eller radera e-post, arkivera meddelanden, komma åt e-postbilagor, organisera e-post med etiketter och så vidare. Bibliotekets aktiva utveckling och öppna källkod betyder att det fortsätter att förbättras och anpassas till förändringar i Gmail API. Förutom några fantastiska funktioner finns det också vissa begränsningar, såsom att OAuth2 ännu inte stöds och att det förlitar sig på IMAP, vilket kanske inte exponerar alla Gmail-specifika funktioner. Det är ett perfekt val för skriptuppgifter eller för att integrera Gmail i lätta Ruby-applikationer.

Previous Next

Komma igång med Mail

Det enklaste sättet att installera Ruby-Gmail-biblioteket är via RubyGems. Använd följande kommando för enkel installation.

Installera Ruby-Gmail via Rubygems

gem install gmail

E-postautentisering i Ruby-appar

Det öppna källkods‑biblioteket Ruby‑Gmail stöder flera autentiseringsmetoder inklusive OAuth2 och enkel användarnamn/lösenord. Det möjliggör enkel inloggning med en Gmail‑adress och lösenord eller app‑specifikt lösenord (rekommenderas för konton med 2FA). Alternativt, om du behöver använda OAuth eller hantera inloggning utanför skriptet, stöder Ruby‑Gmail blockbaserad anslutning. Observera att du av säkerhetsskäl bör undvika att hårdkoda lösenord; använd miljövariabler eller hemlighets‑hantering. Följande kodexempel visar båda metoderna för att hantera e‑postautentisering via Ruby‑API.

Hur utför man grundläggande & OAuth2 e‑postautentisering i Ruby‑appar?

require 'gmail'

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

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

Sök och filtrera e-post via Ruby API

Ruby‑Gmail‑biblioteket har levererat fullständig funktionalitet för att enkelt läsa och söka e‑postmeddelanden i Ruby‑applikationer. Utvecklare kan komma åt inkorgen, olästa meddelanden eller söka efter ämne, avsändare eller datum med lätthet. Biblioteket erbjuder ett robust sökgränssnitt som speglar Gmail:s egna sökoperatorer. Följande exempel visar hur mjukvaruutvecklare kan använda olika metoder för att söka e‑postmeddelanden i Ruby‑appar.

Hur söker man e‑postmeddelanden i Gmail via 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-postkomposition & sändning via Ruby

Det öppna källkodsbiblioteket Ruby-Gmail har gett fullständigt stöd för att skapa och skicka e‑postmeddelanden med bara ett par rader Ruby‑kod. Biblioteket gör det enkelt att komponera och skicka e‑post, möjliggör att lägga till HTML‑innehåll, filer och bildbilagor, skicka massutskick, tillämpa stilar och formatering, och så vidare. Följande exempel visar hur mjukvaruutvecklare kan lägga till HTML‑innehåll och bilagor i e‑postmeddelanden i Ruby‑appar.

Hur lägger man till HTML‑innehåll & bilagor i ett e‑postmeddelande via Ruby‑appar?

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

Arkivera, radera & flytta e-post via Ruby API

Ruby-Gmail‑biblioteket är mycket funktionsrikt och kan hantera e‑postens livscykeloperationer smidigt i Ruby‑applikationer. Mjukvaruutvecklare kan enkelt hantera e‑post genom att flytta, märka, markera som läst/oläst osv. De kan också enkelt markera e‑post som stjärnmärkt, oläst eller till och med flytta dem till olika mappar. Följande Ruby‑kodexempel visar hur man markerar e‑post, lägger till etiketter och flyttar dem till en mapp i Ruby‑applikationer.

Hur markerar man e‑post, lägger till etiketter och flyttar till en specifik mapp via Ruby‑biblioteket?

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