1. Produkte
  2.   Email
  3.   Ruby
  4.   Ruby-Gmail
 
  

Open-Source Ruby E-Mail-Erstellungs- und Verarbeitungsbibliothek

Kostenlose Ruby-API, die Ruby-Apps den Zugriff auf und die Manipulation von Gmail-Konten über IMAP ermöglicht. E-Mails verfassen, senden, archivieren, verschieben und löschen mit der Ruby-Bibliothek.

Was ist die Ruby‑Gmail‑Bibliothek?

In einer Zeit, in der E-Mails nach wie vor eine entscheidende Rolle in Kommunikationsabläufen spielen, müssen Softwareentwickler häufig programmgesteuert mit Gmail interagieren. Ob beim Abrufen von Berichten, Versenden automatischer Benachrichtigungen oder Überwachen von Posteingängen – die richtigen Werkzeuge können Stunden an Aufwand einsparen. Ruby-Gmail ist ein Open-Source‑Ruby‑Gem, das eine einfache, ruby‑artige Schnittstelle zu Gmail über das IMAP‑Protokoll bereitstellt. Entwickelt von dem Entwickler dcparker, abstrahiert die Bibliothek die Komplexität der Arbeit mit rohen IMAP‑Befehlen und bietet stattdessen lesbare, ausdrucksstarke Methoden zum Arbeiten mit Gmail‑Posteingängen, E-Mails, Labels, Anhängen und mehr. Mit nur wenigen Zeilen Ruby‑Code können Softwareentwickler mehrteilige E-Mail‑Nachrichten im Klartext und/oder HTML erstellen und senden, inklusive eingebetteter Bilder und Anhänge.

Ruby-Gmail ist ein verstecktes Juwel für Rubyisten, die eine minimale, elegante Schnittstelle zur Automatisierung von Gmail-Aufgaben suchen. Die Bibliothek enthält verschiedene Funktionen für die Arbeit mit Gmail-E-Mails, wie die Authentifizierung bei Gmail, das Lesen, Suchen oder Filtern von E-Mails, das Erstellen und Senden von Nachrichten, das Entfernen oder Löschen von E-Mails, das Archivieren von Nachrichten, den Zugriff auf E-Mail-Anhänge, das Organisieren von E-Mails mit Labels usw. Die aktive Entwicklung und die Open-Source‑Natur der Bibliothek bedeuten, dass sie sich kontinuierlich verbessert und an Änderungen der Gmail‑API anpasst. Neben einigen großartigen Funktionen gibt es auch einige Einschränkungen, wie dass OAuth2 noch nicht unterstützt wird und die Bibliothek auf IMAP basiert, was möglicherweise nicht alle Gmail‑spezifischen Funktionen bereitstellt. Sie ist ideal für Skriptaufgaben oder die Integration von Gmail in leichte Ruby‑Anwendungen.

Previous Next

Erste Schritte mit Mail

Der einfachste Weg, die Ruby-Gmail-Bibliothek zu installieren, ist über RubyGems. Bitte verwenden Sie den folgenden Befehl für eine einfache Installation.

Installiere Ruby-Gmail über Rubygems

gem install gmail

E‑Mail‑Authentifizierung in Ruby‑Apps

Die Open-Source-Bibliothek Ruby-Gmail unterstützt mehrere Authentifizierungsmethoden, einschließlich OAuth2 und einfachem Benutzername/Passwort. Sie ermöglicht eine einfache Anmeldung mit einer Gmail-Adresse und einem Passwort oder einem app-spezifischen Passwort (empfohlen für Konten mit 2FA). Alternativ, wenn Sie OAuth verwenden müssen oder die Anmeldung außerhalb des Skripts handhaben, unterstützt Ruby-Gmail blockbasierte Verbindungen. Bitte beachten Sie aus Sicherheitsgründen, Passwörter nicht hart zu codieren; verwenden Sie Umgebungsvariablen oder ein Geheimnis‑Management. Die folgenden Codebeispiele demonstrieren beide Methoden zur Verarbeitung von E‑Mail‑Authentifizierungen über die Ruby‑API.

Wie führt man grundlegende & OAuth2-E-Mail-Authentifizierung in Ruby-Anwendungen durch?

require 'gmail'

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

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

E‑Mails über die Ruby‑API suchen und filtern

Die Ruby-Gmail-Bibliothek bietet vollständige Funktionalität zum einfachen Lesen und Durchsuchen von E‑Mail‑Nachrichten in Ruby‑Anwendungen. Entwickler können problemlos auf den Posteingang, ungelesene Nachrichten oder die Suche nach Betreff, Absender oder Datum zugreifen. Die Bibliothek stellt eine robuste Suchoberfläche bereit, die die eigenen Suchoperatoren von Gmail nachbildet. Das folgende Beispiel zeigt, wie Softwareentwickler verschiedene Methoden zum Durchsuchen von E‑Mail‑Nachrichten in Ruby‑Apps anwenden können.

Wie sucht man E-Mail-Nachrichten in Gmail über die 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‑Mail‑Erstellung & Versand mit Ruby

Die Open-Source Ruby-Gmail-Bibliothek bietet vollständige Unterstützung für das Erstellen und Senden von E-Mail-Nachrichten mit nur wenigen Zeilen Ruby-Code. Die Bibliothek macht das Verfassen und Senden von E-Mails unkompliziert und ermöglicht das Hinzufügen von HTML-Inhalten, Dateien und Bildanhängen, das Versenden von Massen-E-Mails, das Anwenden von Stilen und Formatierungen usw. Das folgende Beispiel zeigt, wie Softwareentwickler HTML-Inhalte und Anhänge zu E-Mail-Nachrichten in Ruby-Anwendungen hinzufügen können.

Wie fügt man HTML-Inhalte & Anhänge zu einer E-Mail-Nachricht über Ruby-Anwendungen hinzu?

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

E‑Mails archivieren, löschen und verschieben über die Ruby‑API

Die Ruby-Gmail-Bibliothek ist sehr funktionsreich und kann E-Mail-Lebenszyklus‑Operationen reibungslos in Ruby-Anwendungen handhaben. Softwareentwickler können E-Mails einfach verwalten, indem sie sie verschieben, labeln, als gelesen/ungelesen markieren usw. Sie können E-Mails auch als markiert, ungelesen kennzeichnen oder sogar in verschiedene Ordner verschieben. Das folgende Ruby-Codebeispiel demonstriert, wie man E-Mails markiert, Labels hinzufügt und sie in Ordner innerhalb von Ruby-Anwendungen verschiebt.

Wie markiert man E-Mails, fügt Labels hinzu und verschiebt sie in einen bestimmten Ordner über die Ruby-Bibliothek?

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