Mit Labels können Sie Nachrichten und Threads in Gmail taggen, organisieren und kategorisieren. Ein Label steht in einer n:n-Beziehung zu Nachrichten und Threads: Sie können einer einzelnen Nachricht oder einem Thread mehrere Labels und mehreren Nachrichten oder Threads ein einzelnes Label zuweisen.
Informationen zum Erstellen, Abrufen, Auflisten, Aktualisieren oder Löschen von Labels finden Sie in der Labels-Referenz.
Zum Verwalten von Labels müssen Sie den Bereich https://www.googleapis.com/auth/gmail.labels verwenden. Weitere Informationen zu Bereichen finden Sie unter Informationen zur Autorisierung und Authentifizierung der Gmail API.
Labeltypen
Es gibt zwei Arten von Labels: reservierte SYSTEM-Labels und benutzerdefinierte USER-Labels.
Systemlabels entsprechen in der Regel vordefinierten Elementen auf der Gmail-Weboberfläche wie dem Posteingang. Die Namen von Systemlabels sind reserviert. Kein USER-Label kann 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 im From-Header 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-Benutzeroberflä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-Benutzeroberflä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-Benutzeroberfläche angezeigt werden. |
Labels in Nachrichten und Threads verwalten
Labels sind nur für Nachrichten vorhanden. Wenn Sie beispielsweise Labels in einem Thread auflisten, erhalten Sie eine Liste der Labels, die in allen Nachrichten innerhalb des Threads vorhanden sind. Ein Label ist möglicherweise nicht für jede Nachricht innerhalb eines Threads vorhanden. Sie können Nachrichten mit mehreren Labels versehen, aber nicht auf Nachrichtenentwürfe.
Labels zu Threads hinzufügen oder entfernen
Wenn Sie einem Thread ein Label hinzufügen oder entfernen, wird das angegebene Label allen vorhandenen Nachrichten in der Konversation hinzugefügt oder daraus entfernt.
Wenn Nachrichten einer Konversation hinzugefügt werden, nachdem Sie ein Label hinzugefügt haben, übernehmen die neuen Nachrichten nicht das vorhandene Label, das der Konversation zugeordnet ist. Um diesen Nachrichten das Label hinzuzufügen, fügen Sie das Label dem Thread wieder hinzu.
Verwenden Sie threads.modify, um die mit einem Thread verknüpften Labels hinzuzufügen oder zu entfernen.
Labels zu Nachrichten hinzufügen oder entfernen
Wenn Sie einer Nachricht ein Label hinzufügen, wird das Label der Nachricht hinzugefügt und mit dem Thread verknüpft, zu dem die Nachricht gehört. Das Label wird nicht anderen Nachrichten innerhalb des Threads hinzugefügt.
Wenn Sie ein Label von 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 einer Nachricht hinzufügen oder entfernen.