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 mehrere Labels auf eine einzelne Nachricht oder einen Thread 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.
Zum Verwalten von Labels müssen Sie den Bereich https://www.googleapis.com/auth/gmail.labels verwenden. Weitere Informationen zu Bereichen finden Sie unter Spezielle Autorisierungs- und Authentifizierungsinformationen für die Gmail API.
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 wie dem Posteingang. Systemlabelnamen sind reserviert. Kein USER-Label kann mit demselben Namen wie ein beliebiges 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 für Nachrichten und Threads verwalten
Labels sind nur für Nachrichten vorhanden. Wenn Sie beispielsweise Labels einer Konversation auflisten, erhalten Sie eine Liste der Labels, die in jeder Nachricht in der Konversation vorhanden sind. Ein Label ist möglicherweise nicht für jede Nachricht in einer Konversation vorhanden. Sie können Nachrichten mit mehreren Labels versehen, Nachrichtenentwürfen jedoch nicht.
Labels zu Threads hinzufügen oder entfernen
Wenn Sie einem Thread ein Label hinzufügen oder daraus 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 mit dem Thread verknüpft ist. Um diesen Nachrichten das Label hinzuzufügen, fügen Sie dem Thread das Label noch einmal hinzu.
Verwenden Sie threads.modify, um die mit einem Thread verknüpften Labels hinzuzufügen oder zu entfernen.
Labels hinzufügen oder entfernen
Wenn Sie einer Nachricht ein Label hinzufügen, wird die Nachricht mit dem Label versehen und mit dem Thread verknüpft, zu dem die Nachricht gehört. Das Label wird anderen Nachrichten innerhalb des Threads nicht hinzugefügt.
Wenn Sie ein Label von einer Nachricht entfernen und dies die einzige Nachricht in der Konversation mit diesem Label war, wird das Label auch aus der Konversation entfernt.
Verwenden Sie messages.modify, um Labels, die einer Nachricht zugewiesen wurden, hinzuzufügen oder zu entfernen.