Mit Labels können Sie Nachrichten und Threads in Gmail taggen, organisieren und kategorisieren. Ein Label hat eine m:n-Beziehung zu Nachrichten und Threads: Sie können einer einzelnen Nachricht oder einem einzelnen Thread mehrere Labels zuweisen und ein einzelnes Label auf mehrere Nachrichten oder Threads anwenden.
Informationen zum create, Abrufen, Auflisten, Aktualisieren und Löschen von Labels finden Sie in der Referenz zu Labels.
Wenn Sie Labels verwalten möchten, müssen Sie den Bereich https://www.googleapis.com/auth/gmail.labels verwenden. Weitere Informationen zu Bereichen finden Sie unter Gmail API-spezifische Autorisierungs- und Authentifizierungsinformationen.
Arten von Labels
Es gibt zwei Arten von Labels: reservierte SYSTEM-Labels und benutzerdefinierte USER-Labels.
Systemlabels entsprechen in der Regel vordefinierten Elementen in der Gmail-Weboberfläche, z. B. dem Posteingang. Namen von Systemlabels sind reserviert. Es kann kein USER-Label mit demselben Namen wie ein SYSTEM-Label erstellt werden. In der folgenden Tabelle sind einige der gängigsten Gmail-Systemlabels aufgeführt:
| Name | Kann manuell angewendet werden | Hinweise |
|---|---|---|
INBOX |
Ja | |
SPAM |
Ja | |
TRASH |
Ja | |
UNREAD |
Ja | |
STARRED |
Ja | |
IMPORTANT |
Ja | |
SENT |
Nein | Wird automatisch auf Nachrichten angewendet, die mit drafts.send oder messages.send gesendet, mit messages.insert und der E-Mail-Adresse des Nutzers in der From-Überschrift eingefügt oder vom Nutzer über die Weboberfläche gesendet werden. |
DRAFT |
Nein | Wird automatisch auf alle draft-Nachrichten angewendet, die mit der Gmail API oder der Gmail-Benutzeroberfläche erstellt wurden. |
CATEGORY_PERSONAL |
Ja | Entspricht Nachrichten, die auf dem Tab „Persönlich“ der Gmail-Oberfläche angezeigt werden. |
CATEGORY_SOCIAL |
Ja | Entspricht Nachrichten, die auf dem Tab „Soziale Netzwerke“ der Gmail-Benutzeroberfläche angezeigt werden. |
CATEGORY_PROMOTIONS |
Ja | Entspricht Nachrichten, die auf dem Tab „Werbung“ der Gmail-Oberfläche angezeigt werden. |
CATEGORY_UPDATES |
Ja | Entspricht Nachrichten, die auf dem Tab „Updates“ der Gmail-Benutzeroberfläche angezeigt werden. |
CATEGORY_FORUMS |
Ja | Entspricht Nachrichten, die auf dem Tab „Foren“ der Gmail-Oberfläche angezeigt werden. |
Labels für Nachrichten und Threads verwalten
Labels gibt es nur für Nachrichten. Wenn Sie beispielsweise Label für einen Thread auflisten, erhalten Sie eine Liste der Label, die für eine der Nachrichten im Thread vorhanden sind. Nicht jede Nachricht in einem Thread hat ein Label. Sie können Nachrichten mehrere Labels zuweisen, aber keine Labels auf Nachrichtenentwürfe anwenden.
Threads Labels hinzufügen oder entfernen
Wenn Sie einem Thread ein Label hinzufügen oder daraus entfernen, wird das angegebene Label allen vorhandenen Nachrichten im Thread hinzugefügt oder daraus entfernt.
Wenn einem Thread nach dem Hinzufügen eines Labels Nachrichten hinzugefügt werden, übernehmen die neuen Nachrichten nicht das vorhandene Label, das mit dem Thread verknüpft ist. Wenn Sie das Label diesen Nachrichten hinzufügen möchten, fügen Sie es dem Thread noch einmal hinzu.
Mit threads.modify können Sie einem Thread Labels hinzufügen oder entfernen.
Nachrichten Labels hinzufügen oder entfernen
Wenn Sie einer Nachricht ein Label hinzufügen, wird das Label dieser Nachricht hinzugefügt und mit dem Thread verknüpft, zu dem die Nachricht gehört. Das Label wird nicht anderen Nachrichten im Thread hinzugefügt.
Wenn Sie ein Label aus einer Nachricht entfernen und es sich dabei um die einzige Nachricht im Thread mit diesem Label handelt, wird das Label auch aus dem Thread entfernt.
Mit messages.modify können Sie Labels zu einer Nachricht hinzufügen oder entfernen.