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
  • E‑Mail-Signaturen in einer Organisation standardisieren

Allgemeine Begriffe

Im Folgenden finden Sie eine Liste der in dieser API verwendeten gängigen Begriffe:

Delegierender und Stellvertreter
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 im Namen des Kontos des Bevollmächtigenden lesen, senden und löschen sowie Kontakte ansehen und hinzufügen. Weitere Informationen finden Sie unter Delegierte verwalten.
Draft
Eine nicht gesendete Nachricht. Sie können die Nachricht im Entwurf ersetzen. Wenn Sie einen Entwurf senden, wird er automatisch gelöscht und eine Nachricht mit dem Systemlabel SENT erstellt. Die Ressource drafts stellt einen Entwurf dar. 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 Sie eine Adresse in einer Weiterleitungsregel oder einem Filter verwenden können, müssen Sie sie registrieren und bestätigen, um nachzuweisen, dass Sie der Inhaber sind. Weitere Informationen finden Sie unter Weiterleitung verwalten.
Label

Ein Verfahren zum Organisieren von Nachrichten und Threads. Sie können beispielsweise das Label „Steuern“ erstellen und auf alle Nachrichten und Unterhaltungen anwenden, die sich auf Steuern beziehen. Weitere Informationen finden Sie unter Labels verwalten.

Es gibt zwei Arten von Labels:

Systemlabels
Intern erstellte Labels wie INBOX, TRASH oder SPAM. Sie können diese Labels nicht löschen oder ändern. Sie können jedoch einige Systemlabels wie INBOX auf Nachrichten und Threads anwenden oder daraus entfernen.
Nutzerlabels
Von einem Nutzer erstellte Labels. Ein Nutzer oder eine Anwendung kann diese Labels löschen oder ändern. Die Ressource labels stellt ein Nutzerlabel dar.
Botschaft

Eine E‑Mail-Nachricht mit Absender, Empfängern, Betreff und Text. Nachdem Sie eine Mitteilung erstellt haben, können Sie sie nicht mehr ändern. Die Ressource messages stellt eine Nachricht dar.

Push-Benachrichtigungen

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

S/MIME-Zertifikate

Digitale Zertifikate, die in bestimmte „Senden als“-Aliasse hochgeladen wurden. Mit diesen Zertifikaten können Sie verschlüsselte und digital signierte E‑Mails senden, um die Sicherheit der Nachrichten und die Authentizität des Absenders zu gewährleisten. Weitere Informationen finden Sie unter S/MIME-Zertifikate verwalten.

Als-Aliasse

Sie stehen für 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 „Senden als“ in der Gmail-Weboberfläche und sind auch die Grundlage für die Konfiguration von E‑Mail-Signaturen für einzelne Adressen. Weitere Informationen finden Sie unter Aliasse verwalten.

Thread

Eine Sammlung verwandter Nachrichten, die eine Unterhaltung bilden. In einem E‑Mail-Client entsteht ein Thread, 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.