Mit Labels können Sie Nachrichten und Unterhaltungen in Gmail kennzeichnen, 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 Erstellen, Abrufen, Auflisten, Aktualisieren oder Löschen von Labels finden Sie in der Label-Referenz.
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 API-spezifische Autorisierungs- und Authentifizierungsinformationen.
Labeltypen
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. Systemlabelnamen sind reserviert. Es kann kein USER-Label mit demselben Namen wie ein SYSTEM-Label erstellt werden. In der folgenden Tabelle sind einige der häufigsten 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 eingefügt
und die E-Mail-Adresse des Nutzers im From-Header enthalten sind oder die 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-Oberflä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-Oberfläche angezeigt werden. |
CATEGORY_FORUMS |
Ja | Entspricht Nachrichten, die auf dem Tab „Foren“ der Gmail-Oberfläche angezeigt werden. |
Labels für Nachrichten und Unterhaltungen verwalten
Labels sind nur für Nachrichten verfügbar. Wenn Sie beispielsweise Labels für einen Thread auflisten, erhalten Sie eine Liste der Labels, die für eine der Nachrichten im Thread vorhanden sind. Nicht jede Nachricht in einem Thread hat ein Label. Sie können mehrere Labels auf Nachrichten anwenden, aber nicht auf Nachrichtenentwürfe.
Labels zu Unterhaltungen 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 dem Thread zugewiesen 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 die mit einem Thread verknüpften Labels hinzufügen oder entfernen.
Nachrichten mit Labels versehen oder Labels entfernen
Wenn Sie einer Nachricht ein Label hinzufügen, wird es der Nachricht hinzugefügt und dem Thread zugeordnet, zu dem die Nachricht gehört. Das Label wird nicht zu anderen Nachrichten im Thread hinzugefügt.
Wenn Sie ein Label aus einer Nachricht entfernen und es die einzige Nachricht in der Konversation mit diesem Label war, wird das Label auch aus der Konversation entfernt.
Mit messages.modify können Sie die Labels hinzufügen oder entfernen, die auf eine Nachricht angewendet wurden.