Gmail API – Übersicht

Die Gmail API ist eine RESTful API, mit der Sie auf Gmail-Posteingänge zugreifen und E-Mails senden können. Für die meisten Webanwendungen ist die Gmail API die beste Wahl für den autorisierten Zugriff auf die Gmail-Daten eines Nutzers. Sie eignet sich für verschiedene Anwendungen, z. B.:

  • Nur-Lese-Extraktion, Indexierung und Sicherung von E-Mails
  • Automatisierter oder programmatischer Versand von Nachrichten
  • Migration von E-Mail-Konten
  • E-Mail-Organisation, einschließlich Filtern und Sortieren von Nachrichten
  • Standardisierung von E-Mail-Signaturen in einer Organisation

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste der häufig verwendeten Begriffe in dieser API:

Delegator und Bevollmächtigter
Ein Delegator ist ein Gmail-Nutzer, der einem anderen Nutzer in derselben Google Workspace-Organisation Zugriff auf sein Postfach gewährt. Der Nutzer, der diesen Zugriff erhält, ist der Bevollmächtigte. Bevollmächtigte können Nachrichten lesen, senden und löschen sowie Kontakte im Namen des Kontos des Delegators ansehen und hinzufügen. Weitere Informationen finden Sie unter Bevollmächtigte verwalten.
Entwurf
Eine nicht gesendete Nachricht. Eine Nachricht im Entwurf kann ersetzt werden. Wenn Sie einen Entwurf senden, wird er automatisch gelöscht und eine Nachricht mit dem Systemlabel SENT erstellt. Ein Entwurf wird durch die drafts Ressource dargestellt. Weitere Informationen finden Sie unter Mit Entwürfenarbeiten.
Filter
Erweiterte Regeln, die für ein Konto konfiguriert wurden und eingehende Nachrichten anhand bestimmter Kriterien (z. B. Absender, Betreff oder Größe) auswerten. Wenn eine Nachricht übereinstimmt, lösen Filter automatisch Aktionen aus, z. B. das Hinzufügen oder Entfernen von Labels oder das Weiterleiten der E-Mail an eine bestimmte Adresse. Weitere Informationen finden Sie unter Filter verwalten.
Weiterleitungsadressen
Bestimmte, bestätigte E-Mail-Adressen, die so konfiguriert sind, dass sie automatisch weitergeleitete Nachrichten vom Konto eines Nutzers empfangen. Bevor eine Adresse in einer Weiterleitungsregel oder einem Filter verwendet werden kann, muss sie offiziell registriert und bestätigt werden, um das Eigentum nachzuweisen. Weitere Informationen finden Sie unter Weiterleitung verwalten.
Label

Ein Mechanismus zum Organisieren von Nachrichten und Threads. Beispiel: Das Label „Steuern“ kann erstellt und auf alle Nachrichten und Threads angewendet werden, die mit den Steuern eines Nutzers zu tun haben. Weitere Informationen finden Sie unter Labels verwalten.

Es gibt zwei Arten von Labels:

System labels
Intern erstellte Labels wie INBOX, TRASH oder SPAM. Diese Labels können nicht gelöscht oder geändert werden. Einige Systemlabels wie INBOX können jedoch auf Nachrichten und Threads angewendet oder daraus entfernt werden.
Nutzerlabels
Von einem Nutzer erstellte Labels. Diese Labels können vom Nutzer oder einer Anwendung gelöscht oder geändert werden. Ein Nutzerlabel wird durch die labels Ressource dargestellt.
Nachricht

Eine E-Mail-Nachricht mit Absender, Empfängern, Betreff und Text. Nachdem eine Nachricht erstellt wurde, kann sie nicht mehr geändert werden. Eine Nachricht wird durch die messages Ressource dargestellt.

Push-Benachrichtigungen

Ein serverseitiges Benachrichtigungssystem, das in Google Cloud Pub/Sub integriert ist. Anwendungen können ein Postfach „beobachten“. Die Gmail API sendet dann automatisch Webhooks oder Benachrichtigungen, wenn eine Änderung erfolgt (z. B. wenn eine neue E-Mail eingeht). So muss die App nicht ständig den Server nach Updates abfragen. Weitere Informationen finden Sie unter Push Benachrichtigungen.

S/MIME-Zertifikate

Digitale Zertifikate, die in bestimmte „Senden als“-Aliasse hochgeladen werden und es einem Nutzer ermöglichen, verschlüsselte und digital signierte E-Mails zu senden. So werden die Sicherheit der Nachrichten und die Authentizität des Absenders gewährleistet. Weitere Informationen finden Sie unter S/MIME-Zertifikate verwalten.

„Senden als“-Aliasse

Diese stellen die verschiedenen E-Mail-Adressen dar, von denen aus ein Konto E-Mails senden darf. Jedes Konto hat mindestens einen Alias, der die primäre E-Mail-Adresse darstellt. Aliasse entsprechen der Funktion „E-Mail senden als“ in der Gmail-Weboberfläche und sind auch die Grundlage für die Konfiguration von E-Mail-Signaturen pro Adresse. Weitere Informationen finden Sie unter Aliasse verwalten.

Thread

Eine Sammlung verwandter Nachrichten, die eine Unterhaltung bilden. In einer E-Mail-Client-App wird ein Thread erstellt, wenn ein oder mehrere Empfänger mit einer eigenen Nachricht auf eine Nachricht antworten. Weitere Informationen finden Sie unter Threads verwalten.

  • Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter Entwicklung mit Google Workspace.

  • Informationen zum Konfigurieren und Ausführen einer Gmail API-App finden Sie in den Kurzanleitungen.