Ressource: Label
Mit Labels werden Nachrichten und Threads im Postfach des Nutzers kategorisiert. Für das Postfach eines Nutzers werden maximal 10.000 Labels unterstützt.
JSON-Darstellung |
---|
{ "id": string, "name": string, "messageListVisibility": enum ( |
Felder | |
---|---|
id |
Die unveränderliche ID des Labels. |
name |
Der Anzeigename des Labels. |
messageListVisibility |
Die Sichtbarkeit von Nachrichten mit diesem Label in der Nachrichtenliste in der Gmail-Weboberfläche. |
labelListVisibility |
Die Sichtbarkeit des Labels in der Labelliste in der Gmail-Weboberfläche. |
type |
Der Eigentümertyp für das Label. Nutzerlabels werden vom Nutzer erstellt und können vom Nutzer geändert und gelöscht sowie auf jede Nachricht und jeden Thread angewendet werden. Systemlabels werden intern erstellt und können nicht hinzugefügt, geändert oder gelöscht werden. Systemlabels können unter bestimmten Umständen auf Nachrichten und Threads angewendet oder von ihnen entfernt werden. Dies ist jedoch nicht garantiert. Beispielsweise können Nutzer die Labels |
messagesTotal |
Die Gesamtzahl der Nachrichten mit diesem Label. |
messagesUnread |
Die Anzahl der ungelesenen Nachrichten mit diesem Label. |
threadsTotal |
Die Gesamtzahl der Threads mit dem Label. |
threadsUnread |
Die Anzahl der ungelesenen Threads mit diesem Label. |
color |
Die Farbe, die dem Label zugewiesen werden soll. Die Farbe ist nur für Labels verfügbar, deren |
MessageListVisibility
Enums | |
---|---|
show |
Label in der Nachrichtenliste anzeigen. |
hide |
Label nicht in der Nachrichtenliste anzeigen. |
LabelListVisibility
Enums | |
---|---|
labelShow |
Label in der Labelliste anzeigen. |
labelShowIfUnread |
Label anzeigen, wenn ungelesene Nachrichten mit diesem Label vorhanden sind |
labelHide |
Label nicht in der Labelliste anzeigen. |
Typ
Enums | |
---|---|
system |
Von Gmail erstellte Labels. |
user |
Benutzerdefinierte Labels, die vom Nutzer oder der Anwendung erstellt wurden. |
Farbe
JSON-Darstellung |
---|
{ "textColor": string, "backgroundColor": string } |
Felder | |
---|---|
textColor |
Die Textfarbe des Labels, dargestellt als hexadezimaler String. Dieses Feld ist erforderlich, um die Farbe eines Labels festzulegen. |
backgroundColor |
Die Hintergrundfarbe als Hex-String „#RRGGBB“ (z. B. #000000). Dieses Feld ist erforderlich, um die Farbe eines Labels festzulegen. |
Methoden |
|
---|---|
|
Erstellt ein neues Label. |
|
Das angegebene Label wird sofort und endgültig gelöscht und aus allen Nachrichten und Threads entfernt, auf die es angewendet wurde. |
|
Ruft das angegebene Label ab. |
|
Listet alle Labels im Postfach des Nutzers auf. |
|
Angegebenes Label patchen. |
|
Aktualisiert das angegebene Label. |