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 Nachrichtenversand
  • 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 in dieser API verwendeten gängigen Begriffe:

Delegierender und Delegierter
Ein Delegierender 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 Delegierenden ansehen und hinzufügen. Weitere Informationen finden Sie unter Delegierte verwalten.
Draft
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 Ressource drafts dargestellt. Weitere Informationen finden Sie unter Mit Entwürfen arbeiten.
Filter
Erweiterte Regeln, die für ein Konto konfiguriert sind und eingehende Nachrichten anhand bestimmter Abgleichkriterien (z. B. Absender, Betreff oder Größe) auswerten. Wenn eine Nachricht übereinstimmt, werden durch Filter automatisch Aktionen ausgelöst, 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
Spezifische, bestätigte E‑Mail-Adressen, die so konfiguriert sind, dass automatisch weitergeleitete Nachrichten aus dem Konto eines Nutzers empfangen werden. Bevor eine Adresse in einer Weiterleitungsregel oder einem Filter verwendet werden kann, muss sie offiziell registriert und bestätigt werden, um den Inhaber zu identifizieren. Weitere Informationen finden Sie unter Weiterleitung verwalten.
Label

Ein Verfahren zum Organisieren von Nachrichten und Threads. So kann beispielsweise das Label „Steuern“ erstellt und auf alle Nachrichten und Unterhaltungen angewendet werden, die sich auf die Steuern eines Nutzers beziehen. Weitere Informationen finden Sie unter Labels verwalten.

Es gibt zwei Arten von Labels:

Systemlabels
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 Unterhaltungen angewendet oder daraus entfernt werden.
Nutzerlabels
Von einem Nutzer erstellte Labels. Diese Labels können vom Nutzer oder von einer Anwendung gelöscht oder geändert werden. Ein Nutzerlabel wird durch die Ressource labels dargestellt.
Botschaft

Eine E‑Mail-Nachricht mit Absender, Empfängern, Betreff und Inhalt. Nachdem eine Mitteilung erstellt wurde, kann sie nicht mehr geändert werden. Eine Nachricht wird durch die Ressource messages 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 für bestimmte „Senden als“-Aliasse hochgeladen werden, damit ein Nutzer verschlüsselte und digital signierte E‑Mails senden kann. So werden die Sicherheit der Nachricht und die Authentizität des Absenders gewährleistet. Weitere Informationen finden Sie unter S/MIME-Zertifikate verwalten.

Als-Alias senden

Dies sind die verschiedenen E-Mail-Adressen, über die 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‑Mails 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 auf eine Nachricht mit einer eigenen Nachricht antworten. Weitere Informationen finden Sie unter Threads verwalten.

  • Informationen zur Entwicklung mit Google Workspace APIs, einschließlich der Verarbeitung von 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.