In diesem Dokument wird beschrieben, wie Sie mit der Gmail API Labels für Unterhaltungen und Nachrichten verwalten.
Mit Labels können Sie Nachrichten und Unterhaltungen in Gmail taggen, organisieren und kategorisieren. Ein Label hat eine n:m-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 labels-Ressource.
Wenn Sie Labels verwalten möchten, müssen Sie den nicht vertraulichen Bereich https://www.googleapis.com/auth/gmail.labels verwenden. Weitere Informationen zu Bereichen
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. INBOX. 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 | Sie werden automatisch auf Nachrichten angewendet, die:
|
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 Unterhaltungen und Nachrichten verwalten
Labels sind nur für Nachrichten verfügbar. Wenn Sie eine Liste von Labels für einen Thread abrufen, erhalten Sie eine Liste von Labels, die für eine beliebige Nachricht im Thread vorhanden sind. Ein Label ist möglicherweise nicht für jede Nachricht in einem Thread vorhanden.
Sie können keine Labels auf Nachrichtenentwürfe anwenden.
Labels zu Threads hinzufügen oder daraus 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, wird das vorhandene Label, das dem Thread zugeordnet ist, nicht auf die neuen Nachrichten übertragen. 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.